<!doctype html>
<html lang="zh-cn" dir="ltr">
 <head> 
  <meta charset="UTF-8"> 
  <title>朋友的券专区 - 微信公众平台开发者文档</title> 
  <meta name="generator" content="MediaWiki 1.17.0"> 
  <link rel="shortcut icon" href="../static/assets/b6e57135e9c7167976dba80b3b09b546.jpg"> 
  <link rel="search" type="application/opensearchdescription+xml" href="../7/62453c80507e836458b441eae4358bdf.html" title="微信公众平台开发者文档 (zh-cn)"> 
  <link rel="alternate" type="application/atom+xml" title="微信公众平台开发者文档的Atom订阅" href="../0/594277f21545345653eb965322ac4b04.html"> 
  <link rel="stylesheet" href="../static/02da6b362196e50cd396d4117c7fa3ea.css"> 
  <meta name="keywords" content="微信公众平台开发者文档,微信小店接口,设备功能接口,Weixin JS接口,分组管理接口">
  <meta name="description" content="公众平台是为微信用户提供服务的平台，而公众平台开发接口则是提供服务的基础，开发者在公众平台网站中创建公众号、获取接口权限后，可以通过阅读本接口文档来帮助开发。">
  <meta name="ResourceLoaderDynamicStyles" content=""> 
  <!--[if lt IE 7]><style type="text/css">body{behavior:url("/wiki/skins/vector/csshover.min.htc")}</style><![endif]-->
 </head> 
 <body class="mediawiki ltr ns-0 ns-subject page-朋友的券专区 skin-vector"> 
  <!--网站头部--> 
  <script type="text/javascript" src="../static/021402488e80774f4bae632d50abd818.js"></script> 
  <script>
	function parseURL(){
		var res = {}, search = location.search;
		if (search.indexOf("?") != 0){
			return res;
		}
		search = search.substr(1).split("&");
		for (var i = 0; i < search.length; ++i){
			var 
				item = search[i],
				idx = item.indexOf("="),
				k = item.substr(0, idx),
				v = item.substr(idx+1);
			res[k] = v;
		}
		return res;
	}

	var params = parseURL();
	$(function(){
		$(".portal").each(function(){
			var portal = $(this), as = portal.find('a');

			as.each(function(){
				var a = $(this), title = a.html();

				if (decodeURIComponent(title) == decodeURIComponent(params['title'])){
					portal.addClass("active").find(".body").show();
					a.addClass("selected");
				}
			});
		})
	});
</script> 
  <div class="headWrap"> 
   <div class="header" id="header"> 
    <div class="inner"> 
     <a class="logo" href="../home/index.html"><img src="../static/assets/dc5de672083b2ec495408b00b96c9aab.png" alt="微信公众平台开发者文档"></a> 
    </div> 
   </div> 
  </div>  
  <script type="text/javascript" src="../static/2ef2bdf6ac1839ee639cb15463231282.js"></script> 
  <!--[if IE 6]>
<style type="text/css">
html{background-image:url(about:blank);background-attachment:fixed;}
#content{overflow-x:hidden;}
.bottomnav{position:absolute;top:expression(eval(document.documentElement.scrollTop+document.documentElement.clientHeight-30));}
</style>
<![endif]--> 
  <!--网站头部--> 
  <div id="mw-page-base" class="noprint"></div> 
  <div id="mw-head-base" class="noprint"></div> 
  <div class="mainwrapper"> 
   <div class="inner"> 
    <!-- panel --> 
    <div id="mw-panel" class="noprint"> 
     <!-- 
						<div id="p-logo"><a style="background-image: url(/wiki/skins/common/images/logo.jpg);" href="/wiki/index.php?title=%E9%A6%96%E9%A1%B5"  title="访问首页"></a></div>
					
					<form class="searchform">
						<input type="text"   name="search" placeholder="搜索关键字 [alt-s]" accesskey="s" class="searchform_text"/>
						<input type="submit" name="fulltext" value="搜索" title="搜索该文字的页面" class="searchform_btn"/>
					</form>
					 --> 
     <!-- 开始前必读 --> 
     <div class="portal" id="p-.E5.BC.80.E5.A7.8B.E5.89.8D.E5.BF.85.E8.AF.BB"> 
      <h5><span class="portal_arrow"></span>开始前必读</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.9B.B4.E6.96.B0.E6.97.A5.E5.BF.97"><a href="../0/4c93e31f953f24a42b921d2ae8d4e5e0.html">更新日志</a></li> 
        <li id="n-.E5.BC.80.E5.8F.91.E8.80.85.E8.A7.84.E8.8C.83"><a href="../16/52e198333f5c127ddd5c45e875191b14.html">开发者规范</a></li> 
        <li id="n-.E5.85.AC.E4.BC.97.E5.8F.B7.E6.8E.A5.E5.8F.A3.E6.9D.83.E9.99.90.E8.AF.B4.E6.98.8E"><a href="../13/8d4957b72037e3308a0ca1b21f25ae8d.html">公众号接口权限说明</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E9.A2.91.E7.8E.87.E9.99.90.E5.88.B6.E8.AF.B4.E6.98.8E"><a href="../7/85eff372c164ddc66c47777dc972279f.html">接口频率限制说明</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E8.BF.94.E5.9B.9E.E7.A0.81.E8.AF.B4.E6.98.8E"><a href="../10/6380dc743053a91c544ffd2b7c959166.html">接口返回码说明</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /开始前必读 --> 
     <!-- 开始开发 --> 
     <div class="portal" id="p-.E5.BC.80.E5.A7.8B.E5.BC.80.E5.8F.91"> 
      <h5><span class="portal_arrow"></span>开始开发</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.8E.A5.E5.85.A5.E6.8C.87.E5.8D.97"><a href="../8/f9a0b8382e0b77d87b3bcc1ce6fbc104.html">接入指南</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E6.8E.A5.E5.8F.A3.E8.B0.83.E7.94.A8.E5.87.AD.E6.8D.AE"><a href="../14/9f9c82c1af308e3b14ba9b973f99a8ba.html">获取接口调用凭据</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E5.BE.AE.E4.BF.A1.E6.9C.8D.E5.8A.A1.E5.99.A8IP.E5.9C.B0.E5.9D.80"><a href="../4/41ef0843d6e108cf6b5649480207561c.html">获取微信服务器IP地址</a></li> 
        <li id="n-.E6.8A.A5.E8.AD.A6.E6.8E.92.E6.9F.A5.E6.8C.87.E5.BC.95"><a href="../7/c478375fae59150b26def82ec061f43b.html">报警排查指引</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E6.B5.8B.E8.AF.95.E5.8F.B7.E7.94.B3.E8.AF.B7"><a href="http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login">接口测试号申请</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E5.9C.A8.E7.BA.BF.E8.B0.83.E8.AF.95"><a href="http://mp.weixin.qq.com/debug/">接口在线调试</a></li> 
        <li id="n-.E5.B8.B8.E8.A7.81.E9.97.AE.E9.A2.98"><a href="http://mp.weixin.qq.com/qa">常见问题</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /开始开发 --> 
     <!-- 自定义菜单 --> 
     <div class="portal" id="p-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95"> 
      <h5><span class="portal_arrow"></span>自定义菜单</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95.E5.88.9B.E5.BB.BA.E6.8E.A5.E5.8F.A3"><a href="../10/0234e39a2025342c17a7d23595c6b40a.html">自定义菜单创建接口</a></li> 
        <li id="n-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95.E6.9F.A5.E8.AF.A2.E6.8E.A5.E5.8F.A3"><a href="../5/f287d1a5b78a35a8884326312ac3e4ed.html">自定义菜单查询接口</a></li> 
        <li id="n-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95.E5.88.A0.E9.99.A4.E6.8E.A5.E5.8F.A3"><a href="../3/de21624f2d0d3dafde085dafaa226743.html">自定义菜单删除接口</a></li> 
        <li id="n-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../19/a037750e2df0261ab0a84899d16abd33.html">自定义菜单事件推送</a></li> 
        <li id="n-.E4.B8.AA.E6.80.A7.E5.8C.96.E8.8F.9C.E5.8D.95.E6.8E.A5.E5.8F.A3"><a href="../0/c48ccd12b69ae023159b4bfaa7c39c20.html">个性化菜单接口</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E5.85.AC.E4.BC.97.E5.8F.B7.E7.9A.84.E8.8F.9C.E5.8D.95.E9.85.8D.E7.BD.AE"><a href="../14/293d0cb8de95e916d1216a33fcb81fd6.html">获取公众号的菜单配置</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /自定义菜单 --> 
     <!-- 消息管理 --> 
     <div class="portal" id="p-.E6.B6.88.E6.81.AF.E7.AE.A1.E7.90.86"> 
      <h5><span class="portal_arrow"></span>消息管理</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.8E.A5.E6.94.B6.E6.B6.88.E6.81.AF-.E6.8E.A5.E6.94.B6.E6.99.AE.E9.80.9A.E6.B6.88.E6.81.AF"><a href="../17/f298879f8fb29ab98b2f2971d42552fd.html">接收消息-接收普通消息</a></li> 
        <li id="n-.E6.8E.A5.E6.94.B6.E6.B6.88.E6.81.AF-.E6.8E.A5.E6.94.B6.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../7/9f89d962eba4c5924ed95b513ba69d9b.html">接收消息-接收事件推送</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E8.A2.AB.E5.8A.A8.E5.9B.9E.E5.A4.8D.E6.B6.88.E6.81.AF"><a href="../1/6239b44c206cab9145b1d52c67e6c551.html">发送消息-被动回复消息</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E8.A2.AB.E5.8A.A8.E5.9B.9E.E5.A4.8D.E6.97.B6.E7.9A.84.E5.8A.A0.E8.A7.A3.E5.AF.86"><a href="../14/70e73cedf9fd958d2e23264ba9333ad2.html">发送消息-被动回复时的加解密</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E5.AE.A2.E6.9C.8D.E6.B6.88.E6.81.AF"><a href="../11/c88c270ae8935291626538f9c64bd123.html">发送消息-客服消息</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E7.BE.A4.E5.8F.91.E6.8E.A5.E5.8F.A3"><a href="../15/40b6865b893947b764e2de8e4a1fb55f.html">发送消息-群发接口</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E6.A8.A1.E6.9D.BF.E6.B6.88.E6.81.AF.E6.8E.A5.E5.8F.A3"><a href="../5/6dde9eaa909f83354e0094dc3ad99e05.html">发送消息-模板消息接口</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E6.A8.A1.E6.9D.BF.E6.B6.88.E6.81.AF.E8.BF.90.E8.90.A5.E8.A7.84.E8.8C.83"><a href="../18/8ecd0dfc9acafb2ed86ac3ae8f7c69aa.html">发送消息-模板消息运营规范</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E5.85.AC.E4.BC.97.E5.8F.B7.E8.87.AA.E5.8A.A8.E5.9B.9E.E5.A4.8D.E9.85.8D.E7.BD.AE"><a href="../8/806878e1fc2b9e9aa618ae33896b04c4.html">获取公众号自动回复配置</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /消息管理 --> 
     <!-- 微信网页开发 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E7.BD.91.E9.A1.B5.E5.BC.80.E5.8F.91"> 
      <h5><span class="portal_arrow"></span>微信网页开发</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E7.BD.91.E9.A1.B5.E6.8E.88.E6.9D.83"><a href="../4/9ac2e7b1f1d22e9e57260f6553822520.html">微信网页授权</a></li> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E7.BD.91.E9.A1.B5.E5.BC.80.E5.8F.91.E6.A0.B7.E5.BC.8F.E5.BA.93"><a href="../2/ae9782fb42e47ad79eb7b361c2149d16.html">微信网页开发样式库</a></li> 
        <li id="n-.E5.BE.AE.E4.BF.A1JS-SDK"><a href="../11/74ad127cc054f6b80759c40f77ec03db.html">微信JS-SDK</a></li> 
        <li id="n-.E5.BE.AE.E4.BF.A1Web.E5.BC.80.E5.8F.91.E8.80.85.E5.B7.A5.E5.85.B7"><a href="../10/e5f772f4521da17fa0d7304f68b97d7e.html">微信Web开发者工具</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信网页开发 --> 
     <!-- 素材管理 --> 
     <div class="portal" id="p-.E7.B4.A0.E6.9D.90.E7.AE.A1.E7.90.86"> 
      <h5><span class="portal_arrow"></span>素材管理</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.96.B0.E5.A2.9E.E4.B8.B4.E6.97.B6.E7.B4.A0.E6.9D.90"><a href="../15/2d353966323806a202cd2deaafe8e557.html">新增临时素材</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E4.B8.B4.E6.97.B6.E7.B4.A0.E6.9D.90"><a href="../9/677a85e3f3849af35de54bb5516c2521.html">获取临时素材</a></li> 
        <li id="n-.E6.96.B0.E5.A2.9E.E6.B0.B8.E4.B9.85.E7.B4.A0.E6.9D.90"><a href="../10/10ea5a44870f53d79449290dfd43d006.html">新增永久素材</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E6.B0.B8.E4.B9.85.E7.B4.A0.E6.9D.90"><a href="../12/3c12fac7c14cb4d0e0d4fe2fbc87b638.html">获取永久素材</a></li> 
        <li id="n-.E5.88.A0.E9.99.A4.E6.B0.B8.E4.B9.85.E7.B4.A0.E6.9D.90"><a href="../7/2212203f4e17253b9aef77dc788f5337.html">删除永久素材</a></li> 
        <li id="n-.E4.BF.AE.E6.94.B9.E6.B0.B8.E4.B9.85.E5.9B.BE.E6.96.87.E7.B4.A0.E6.9D.90"><a href="../10/c7bad9a463db20ff8ccefeedeef51f9e.html">修改永久图文素材</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.B4.A0.E6.9D.90.E6.80.BB.E6.95.B0"><a href="../5/a641fd7b5db7a6a946ebebe2ac166885.html">获取素材总数</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.B4.A0.E6.9D.90.E5.88.97.E8.A1.A8"><a href="../15/8386c11b7bc4cdd1499c572bfe2e95b3.html">获取素材列表</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /素材管理 --> 
     <!-- 用户管理 --> 
     <div class="portal" id="p-.E7.94.A8.E6.88.B7.E7.AE.A1.E7.90.86"> 
      <h5><span class="portal_arrow"></span>用户管理</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E7.94.A8.E6.88.B7.E5.88.86.E7.BB.84.E7.AE.A1.E7.90.86"><a href="../8/d6d33cf60bce2a2e4fb10a21be9591b8.html">用户分组管理</a></li> 
        <li id="n-.E8.AE.BE.E7.BD.AE.E7.94.A8.E6.88.B7.E5.A4.87.E6.B3.A8.E5.90.8D"><a href="../16/528098c4a6a87b05120a7665c8db0460.html">设置用户备注名</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.94.A8.E6.88.B7.E5.9F.BA.E6.9C.AC.E4.BF.A1.E6.81.AF.28UnionID.E6.9C.BA.E5.88.B6.29"><a href="../1/8a5ce6257f1d3b2afb20f83e72b72ce9.html">获取用户基本信息(UnionID机制)</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.94.A8.E6.88.B7.E5.88.97.E8.A1.A8"><a href="../12/54773ff6da7b8bdc95b7d2667d84b1d4.html">获取用户列表</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.94.A8.E6.88.B7.E5.9C.B0.E7.90.86.E4.BD.8D.E7.BD.AE"><a href="../4/0bd25e04332eccf83bc2e71df9d3e860.html">获取用户地理位置</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /用户管理 --> 
     <!-- 帐号管理 --> 
     <div class="portal" id="p-.E5.B8.90.E5.8F.B7.E7.AE.A1.E7.90.86"> 
      <h5><span class="portal_arrow"></span>帐号管理</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E7.94.9F.E6.88.90.E5.B8.A6.E5.8F.82.E6.95.B0.E7.9A.84.E4.BA.8C.E7.BB.B4.E7.A0.81"><a href="../18/167e7d94df85d8389df6c94a7a8f78ba.html">生成带参数的二维码</a></li> 
        <li id="n-.E9.95.BF.E9.93.BE.E6.8E.A5.E8.BD.AC.E7.9F.AD.E9.93.BE.E6.8E.A5.E6.8E.A5.E5.8F.A3"><a href="../6/856aaeb492026466277ea39233dc23ee.html">长链接转短链接接口</a></li> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E8.AE.A4.E8.AF.81.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../10/2adfb2f10828e87aa1e5c3ef83b17906.html">微信认证事件推送</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /帐号管理 --> 
     <!-- 数据统计 --> 
     <div class="portal" id="p-.E6.95.B0.E6.8D.AE.E7.BB.9F.E8.AE.A1"> 
      <h5><span class="portal_arrow"></span>数据统计</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E7.94.A8.E6.88.B7.E5.88.86.E6.9E.90.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><a href="../15/88726a421bfc54654a3095821c3ca3bb.html">用户分析数据接口</a></li> 
        <li id="n-.E5.9B.BE.E6.96.87.E5.88.86.E6.9E.90.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><a href="../9/d347c6ddb6f86ab11ec3b41c2729c8d9.html">图文分析数据接口</a></li> 
        <li id="n-.E6.B6.88.E6.81.AF.E5.88.86.E6.9E.90.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><a href="../10/b29e8ca8bf1b0dce033ccb70273f90fa.html">消息分析数据接口</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E5.88.86.E6.9E.90.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><a href="../17/252a976f20bd3062af3f03a45f30cff9.html">接口分析数据接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /数据统计 --> 
     <!-- 微信小店 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E5.B0.8F.E5.BA.97"> 
      <h5><span class="portal_arrow"></span>微信小店</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E5.B0.8F.E5.BA.97.E6.8E.A5.E5.8F.A3"><a href="../6/ae98ac4a7219405153cedc9dddccacca.html">微信小店接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信小店 --> 
     <!-- 微信卡券 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E5.8D.A1.E5.88.B8"> 
      <h5><span class="portal_arrow"></span>微信卡券</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E5.8D.A1.E5.88.B8.E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E"><a href="../10/597cb57750f375a4b37e2536fd3331ea.html">微信卡券接口说明</a></li> 
        <li id="n-.E5.88.9B.E5.BB.BA.E5.8D.A1.E5.88.B8"><a href="../15/e33671f4ef511b77755142b37502928f.html">创建卡券</a></li> 
        <li id="n-.E6.8A.95.E6.94.BE.E5.8D.A1.E5.88.B8"><a href="../5/f942979ef2f0d313d4d36e3a26766a3d.html">投放卡券</a></li> 
        <li id="n-.E6.A0.B8.E9.94.80.E5.8D.A1.E5.88.B8"><a href="../15/bdfd0c3c6c3b0629e8a425936a973d8b.html">核销卡券</a></li> 
        <li id="n-.E7.AE.A1.E7.90.86.E5.8D.A1.E5.88.B8"><a href="../14/8dd77aeaee85f922db5f8aa6386d385e.html">管理卡券</a></li> 
        <li id="n-.E5.8D.A1.E5.88.B8.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../16/28b34ee91675a04cb24853768debded4.html">卡券事件推送</a></li> 
        <li id="n-.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E4.B8.93.E5.8C.BA"><a href="../10/333958907c5aae0581e93a24f2df8562.html">朋友的券专区</a></li> 
        <li id="n-.E4.BC.9A.E5.91.98.E5.8D.A1.E4.B8.93.E5.8C.BA"><a href="../15/de148cc4b5190c80002eaf4f6f26c717.html">会员卡专区</a></li> 
        <li id="n-.E7.89.B9.E6.AE.8A.E7.A5.A8.E5.88.B8"><a href="../11/a42da6431597edff7caeaf5d33fac37b.html">特殊票券</a></li> 
        <li id="n-.E7.AC.AC.E4.B8.89.E6.96.B9.E4.BB.A3.E5.88.B6.E4.B8.93.E5.8C.BA"><a href="../13/a1b2bedbca3990108195f13bd7e27401.html">第三方代制专区</a></li> 
        <li id="n-.E5.8D.A1.E5.88.B8.E9.94.99.E8.AF.AF.E7.A0.81"><a href="../7/981e7a73e2bca37a3d1c83f071be6947.html">卡券错误码</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信卡券 --> 
     <!-- 微信门店 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E9.97.A8.E5.BA.97"> 
      <h5><span class="portal_arrow"></span>微信门店</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E9.97.A8.E5.BA.97.E6.8E.A5.E5.8F.A3"><a href="../11/081986f089826bf94393bef9bf287b8b.html">微信门店接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信门店 --> 
     <!-- 微信智能接口 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E6.99.BA.E8.83.BD.E6.8E.A5.E5.8F.A3"> 
      <h5><span class="portal_arrow"></span>微信智能接口</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E8.AF.AD.E4.B9.89.E7.90.86.E8.A7.A3.E6.8E.A5.E5.8F.A3"><a href="../10/65eb7a43f078cc609cf08dae6805f4a6.html">语义理解接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信智能接口 --> 
     <!-- 微信设备功能 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E8.AE.BE.E5.A4.87.E5.8A.9F.E8.83.BD"> 
      <h5><span class="portal_arrow"></span>微信设备功能</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E8.AE.BE.E5.A4.87.E5.8A.9F.E8.83.BD.E4.BB.8B.E7.BB.8D"><a href="../2/77400d13dc7fca83181bc9806d55b6ce.html">设备功能介绍</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信设备功能 --> 
     <!-- 微信多客服功能 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E5.A4.9A.E5.AE.A2.E6.9C.8D.E5.8A.9F.E8.83.BD"> 
      <h5><span class="portal_arrow"></span>微信多客服功能</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.B0.86.E6.B6.88.E6.81.AF.E8.BD.AC.E5.8F.91.E5.88.B0.E5.A4.9A.E5.AE.A2.E6.9C.8D"><a href="../11/f0e34a15cec66fefb28cf1c0388f68ab.html">将消息转发到多客服</a></li> 
        <li id="n-.E5.AE.A2.E6.9C.8D.E7.AE.A1.E7.90.86"><a href="../18/749901f4e123170fb8a4d447ae6040ba.html">客服管理</a></li> 
        <li id="n-.E5.A4.9A.E5.AE.A2.E6.9C.8D.E4.BC.9A.E8.AF.9D.E6.8E.A7.E5.88.B6"><a href="../4/4b256cfb246b22ad020e07cf8a61a738.html">多客服会话控制</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E5.AE.A2.E6.9C.8D.E8.81.8A.E5.A4.A9.E8.AE.B0.E5.BD.95"><a href="../3/178d2982bd590adf33fc03cf6cf45b33.html">获取客服聊天记录</a></li> 
        <li id="n-PC.E5.AE.A2.E6.88.B7.E7.AB.AF.E8.87.AA.E5.AE.9A.E4.B9.89.E6.8F.92.E4.BB.B6.E6.8E.A5.E5.8F.A3"><a href="../8/3634566e351f497f508c7b9d04636724.html">PC客户端自定义插件接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信多客服功能 --> 
     <!-- 微信摇一摇周边 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E6.91.87.E4.B8.80.E6.91.87.E5.91.A8.E8.BE.B9"> 
      <h5><span class="portal_arrow"></span>微信摇一摇周边</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E7.94.B3.E8.AF.B7.E5.BC.80.E9.80.9A.E6.91.87.E4.B8.80.E6.91.87.E5.91.A8.E8.BE.B9"><a href="../19/9fe9fdbb50fee9f9660438c551142ccf.html">申请开通摇一摇周边</a></li> 
        <li id="n-.E8.AE.BE.E5.A4.87.E7.AE.A1.E7.90.86"><a href="../15/095caa2f4a829f0299db617eaf6ad1cf.html">设备管理</a></li> 
        <li id="n-.E9.A1.B5.E9.9D.A2.E7.AE.A1.E7.90.86"><a href="../15/7a21268ed234b4e648d86e3b91118907.html">页面管理</a></li> 
        <li id="n-.E7.B4.A0.E6.9D.90.E7.AE.A1.E7.90.86"><a href="../12/3b10084ee944a702fd06e54a0f10b1d8.html">素材管理</a></li> 
        <li id="n-.E7.AE.A1.E7.90.86.E8.AE.BE.E5.A4.87.E4.B8.8E.E9.A1.B5.E9.9D.A2.E7.9A.84.E5.85.B3.E8.81.94.E5.85.B3.E7.B3.BB"><a href="../6/0eb3f80f152d2edb95287141e7a6ab5e.html">管理设备与页面的关联关系</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E8.AE.BE.E5.A4.87.E5.8F.8A.E7.94.A8.E6.88.B7.E4.BF.A1.E6.81.AF"><a href="../12/f18e741c4cab6652afe3878774672de4.html">获取设备及用户信息</a></li> 
        <li id="n-.E6.95.B0.E6.8D.AE.E7.BB.9F.E8.AE.A1"><a href="../3/15da0147e3722fd689f363497af0c707.html">数据统计</a></li> 
        <li id="n-.E6.91.87.E4.B8.80.E6.91.87.E5.85.B3.E6.B3.A8JSAPI"><a href="../4/94e3b1dc0416633a2d7f1cfaa71240c8.html">摇一摇关注JSAPI</a></li> 
        <li id="n-.E6.91.87.E4.B8.80.E6.91.87.E4.BA.8B.E4.BB.B6.E9.80.9A.E7.9F.A5"><a href="../3/c71248e1b3efb158f258a48b72e67683.html">摇一摇事件通知</a></li> 
        <li id="n-.E6.91.87.E4.B8.80.E6.91.87.E7.BA.A2.E5.8C.85"><a href="../7/0ddd50ed2421b99fedd071281c074aab.html">摇一摇红包</a></li> 
        <li id="n-Html-5.E9.A1.B5.E9.9D.A2.E8.8E.B7.E5.8F.96.E8.AE.BE.E5.A4.87.E4.BF.A1.E6.81.AF"><a href="../11/c156a3e968b0c1e78157e15275dcc54b.html">Html 5页面获取设备信息</a></li> 
        <li id="n-.E6.91.87.E4.B8.80.E6.91.87.E5.91.A8.E8.BE.B9.E9.94.99.E8.AF.AF.E7.A0.81"><a href="../1/8299371e6e11392757b23a6d1e592331.html">摇一摇周边错误码</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信摇一摇周边 --> 
     <!-- 微信连Wi-Fi --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E8.BF.9EWi-Fi"> 
      <h5><span class="portal_arrow"></span>微信连Wi-Fi</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E8.BF.9EWi-Fi.E5.BC.80.E5.8F.91.E8.80.85.E6.8C.87.E5.BC.95"><a href="../9/fd2d692e28b938a8d618f57cf9c79fb1.html">微信连Wi-Fi开发者指引</a></li> 
        <li id="n-Wi-Fi.E7.A1.AC.E4.BB.B6.E9.89.B4.E6.9D.83.E5.8D.8F.E8.AE.AE.E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E"><a href="../10/0ef643c7147fdf689e0a780d8c08ab96.html">Wi-Fi硬件鉴权协议接口说明</a></li> 
        <li id="n-Wi-Fi.E8.BD.AF.E4.BB.B6.E6.9C.8D.E5.8A.A1.E7.AE.A1.E7.90.86.E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E"><a href="../14/70e147b2ace3247f88f1c2aaaa57568e.html">Wi-Fi软件服务管理接口说明</a></li> 
        <li id="n-.E5.BC.80.E9.80.9A.E5.BE.AE.E4.BF.A1.E8.BF.9EWi-Fi.E6.8F.92.E4.BB.B6"><a href="../11/a6a3731b23ed4203f5d08030cd5bf4c3.html">开通微信连Wi-Fi插件</a></li> 
        <li id="n-Wi-Fi.E9.97.A8.E5.BA.97.E7.AE.A1.E7.90.86"><a href="../9/0afbb08a0f06e87dd3669a2c1e19edd5.html">Wi-Fi门店管理</a></li> 
        <li id="n-Wi-Fi.E8.AE.BE.E5.A4.87.E7.AE.A1.E7.90.86"><a href="../17/438e819a53e9426b202c3bc0afbad749.html">Wi-Fi设备管理</a></li> 
        <li id="n-.E9.85.8D.E7.BD.AE.E8.BF.9E.E7.BD.91.E6.96.B9.E5.BC.8F"><a href="../17/22648869929525f829a3de1bfc73eb4d.html">配置连网方式</a></li> 
        <li id="n-.E5.95.86.E5.AE.B6.E4.B8.BB.E9.A1.B5.E7.AE.A1.E7.90.86"><a href="../14/4e14adf8639aeb67d42df05cb792da9e.html">商家主页管理</a></li> 
        <li id="n-Wi-Fi.E6.95.B0.E6.8D.AE.E7.BB.9F.E8.AE.A1"><a href="../11/f5f481aeeb62b9b0848315f78123b4d7.html">Wi-Fi数据统计</a></li> 
        <li id="n-.E8.BF.9E.E7.BD.91.E5.90.8E.E4.B8.8B.E5.8F.91.E6.B6.88.E6.81.AF"><a href="../19/bac84e64da24f928c3e536c742d4e0b7.html">连网后下发消息</a></li> 
        <li id="n-Wi-Fi.E9.94.99.E8.AF.AF.E7.A0.81"><a href="../9/b1211ca9404ec481f94e88d0dd344e85.html">Wi-Fi错误码</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信连Wi-Fi --> 
     <!-- 微信扫一扫 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E6.89.AB.E4.B8.80.E6.89.AB"> 
      <h5><span class="portal_arrow"></span>微信扫一扫</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.89.AB.E4.B8.80.E6.89.AB.E6.8E.A5.E5.85.A5.E6.8C.87.E5.8D.97"><a href="../19/e833eb10470cc25cad4719677c46ecdb.html">扫一扫接入指南</a></li> 
        <li id="n-.E5.95.86.E5.93.81.E5.88.9B.E5.BB.BA"><a href="../6/c61604ff6890d386d6227945ad4a68d2.html">商品创建</a></li> 
        <li id="n-.E5.95.86.E5.93.81.E5.8F.91.E5.B8.83"><a href="../15/1007691d0f1c10a0588c6517f12ed70f.html">商品发布</a></li> 
        <li id="n-.E5.95.86.E5.93.81.E7.AE.A1.E7.90.86"><a href="../15/7fa787701295b884410b5163e13313af.html">商品管理</a></li> 
        <li id="n-.E6.89.AB.E4.B8.80.E6.89.AB.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../15/f4109a5e44b4bfbc7eb1337eb739f3e3.html">扫一扫事件推送</a></li> 
        <li id="n-.E9.94.99.E8.AF.AF.E7.A0.81"><a href="../7/91dcb5ffa7d087a23299316c3c396e93.html">错误码</a></li> 
        <li id="n-.E5.9C.A8.E7.BA.BF.E5.B8.AE.E5.8A.A9.E5.B7.A5.E5.85.B7"><a href="../11/9f75990a5e9f6c09c846fd918921e0d7.html">在线帮助工具</a></li> 
        <li id="n-.E6.89.AB.E4.B8.80.E6.89.AB.E5.B8.B8.E8.A7.81.E9.97.AE.E9.A2.98"><a href="../15/b11cde45d1dcb23a94f493dd1e1320cb.html">扫一扫常见问题</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信扫一扫 --> 
     <!-- SEARCH --> 
     <!-- /SEARCH --> 
     <!-- TOOLBOX --> 
     <!-- /TOOLBOX --> 
     <!-- LANGUAGES --> 
     <!-- /LANGUAGES --> 
    </div> 
    <!-- /panel --> 
    <!-- content --> 
    <div id="content"> 
     <!-- header --> 
     <div id="mw-head" class="noprint" style="visibility:hidden"> 
      <!-- 0 --> 
      <div id="p-personal" class=""> 
       <h5>个人工具</h5> 
       <ul> 
        <li id="pt-anonuserpage"><a href="../0/f33145bff5a2445cabbd49fc12e8f2e0.html" title="您编辑本站所用IP的对应用户页 [.]" accesskey="." class="new">10.9.161.40</a></li> 
        <li id="pt-anontalk"><a href="../12/4aa3e991f9670e48be3d9c6d01c4c568.html" title="对于来自此IP地址的编辑的对话 [n]" accesskey="n" class="new">该IP的讨论页</a></li> 
        <li id="pt-anonlogin"><a href="../12/904658ecb8de15333134d027d83b641c.html" title="我们鼓励您登录，但这并不是必须的 [o]" accesskey="o">登录</a></li> 
       </ul> 
      </div> 
      <!-- /0 --> 
      <div id="left-navigation"> 
       <!-- 0 --> 
       <div id="p-namespaces" class="vectorTabs"> 
        <h5>名字空间</h5> 
        <ul> 
         <li id="ca-nstab-main" class="selected"><span><a href="../10/333958907c5aae0581e93a24f2df8562.html" title="查看页面内容 [c]" accesskey="c">页面</a></span></li> 
         <li id="ca-talk" class="new"><span><a href="#" title="关于页面正文的讨论 [t]" accesskey="t">讨论</a></span></li> 
        </ul> 
       </div> 
       <!-- /0 --> 
       <!-- 1 --> 
       <div id="p-variants" class="vectorMenu emptyPortlet"> 
        <h5><span>变换</span><a href="#"></a></h5> 
        <div class="menu"> 
         <ul> 
         </ul> 
        </div> 
       </div> 
       <!-- /1 --> 
      </div> 
      <div id="right-navigation"> 
       <!-- 0 --> 
       <div id="p-views" class="vectorTabs"> 
        <h5>查看</h5> 
        <ul> 
         <li id="ca-view" class="selected"><span><a href="../10/333958907c5aae0581e93a24f2df8562.html">阅读</a></span></li> 
         <li id="ca-viewsource"><span><a href="#" title="此页面已被保护，你可以查看其源代码。 [e]" accesskey="e">查看源代码</a></span></li> 
         <li id="ca-history" class="collapsible "><span><a href="#" title="此页面的早前修订版本 [h]" accesskey="h">查看历史</a></span></li> 
        </ul> 
       </div> 
       <!-- /0 --> 
       <!-- 1 --> 
       <div id="p-cactions" class="vectorMenu emptyPortlet"> 
        <h5><span>动作</span><a href="#"></a></h5> 
        <div class="menu"> 
         <ul> 
         </ul> 
        </div> 
       </div> 
       <!-- /1 --> 
       <!-- 2 --> 
       <div id="p-search"> 
        <h5><label for="searchInput">搜索</label></h5> 
        <form action="/wiki/index.php" id="searchform"> 
         <input type="hidden" name="title" value="特殊:搜索"> 
         <input id="searchInput" name="search" type="text" title="搜索该网站 [f]" accesskey="f" value=""> 
         <input type="submit" name="go" class="searchButton" id="searchGoButton" value="进入" title="如果相同的标题存在的话便直接前往该页面"> 
         <input type="submit" name="fulltext" class="searchButton" id="mw-searchButton" value="搜索" title="搜索该文字的页面"> 
        </form> 
       </div> 
       <!-- /2 --> 
      </div> 
     </div> 
     <!-- /header --> 
     <a id="top"></a> 
     <div id="mw-js-message" style="display:none;"></div> 
     <!-- firstHeading --> 
     <div class="content_hd"> 
      <h2 id="firstHeading" class="">朋友的券专区</h2> 
      <div class="info"> 
      </div> 
     </div> 
     <!-- /firstHeading --> 
     <!-- bodyContent --> 
     <div id="bodyContent" class="bodyContent"> 
      <!-- tagline --> 
      <div id="siteSub">
       出自微信公众平台开发者文档
      </div> 
      <!-- /tagline --> 
      <!-- subtitle --> 
      <div id="contentSub"></div> 
      <!-- /subtitle --> 
      <!-- jumpto --> 
      <div id="jump-to-nav">
        跳转到： 
       <a href="#mw-head">导航</a>, 
       <a href="#p-search">搜索</a> 
      </div> 
      <!-- /jumpto --> 
      <!-- bodytext --> 
      <table id="toc" class="toc">
       <tbody>
        <tr>
         <td>
          <div id="toctitle">
           <h2>目录</h2>
          </div> 
          <ul> 
           <li class="toclevel-1 tocsection-1"><a href="#.E6.9B.B4.E6.96.B0.E6.97.A5.E5.BF.97"><span class="tocnumber">1</span> <span class="toctext">更新日志</span></a></li> 
           <li class="toclevel-1 tocsection-2"><a href="#.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E7.AE.80.E4.BB.8B"><span class="tocnumber">2</span> <span class="toctext">朋友的券简介</span></a></li> 
           <li class="toclevel-1 tocsection-3"><a href="#.E5.BC.80.E5.8F.91.E8.80.85.E6.B3.A8.E6.84.8F.E4.BA.8B.E9.A1.B9"><span class="tocnumber">3</span> <span class="toctext">开发者注意事项</span></a></li> 
           <li class="toclevel-1 tocsection-4"><a href="#.E5.88.9B.E5.BB.BA.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8"><span class="tocnumber">4</span> <span class="toctext">创建朋友的券</span></a> 
            <ul> 
             <li class="toclevel-2 tocsection-5"><a href="#.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.A0.B7.E5.BC.8F"><span class="tocnumber">4.1</span> <span class="toctext">朋友的券样式</span></a></li> 
             <li class="toclevel-2 tocsection-6"><a href="#.E6.8E.A5.E5.8F.A3.E8.B0.83.E7.94.A8.E8.AF.B4.E6.98.8E"><span class="tocnumber">4.2</span> <span class="toctext">接口调用说明</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-7"><a href="#.E9.80.89.E6.8B.A9.E5.90.88.E9.80.82.E7.9A.84.E9.97.A8.E6.A7.9B.E7.B1.BB.E5.9E.8B"><span class="tocnumber">4.2.1</span> <span class="toctext">选择合适的门槛类型</span></a></li> 
               <li class="toclevel-3 tocsection-8"><a href="#.E9.80.89.E6.8B.A9.E5.90.88.E9.80.82.E7.9A.84code.E6.98.BE.E7.A4.BA.E7.B1.BB.E5.9E.8B"><span class="tocnumber">4.2.2</span> <span class="toctext">选择合适的code显示类型</span></a></li> 
               <li class="toclevel-3 tocsection-9"><a href="#.E8.AE.B0.E5.BD.95.E7.94.A8.E6.88.B7.E9.A2.86.E5.88.B8.E8.A1.8C.E4.B8.BA"><span class="tocnumber">4.2.3</span> <span class="toctext">记录用户领券行为</span></a></li> 
               <li class="toclevel-3 tocsection-10"><a href="#.E6.B4.BB.E7.94.A8.E8.87.AA.E5.AE.9A.E4.B9.89.E5.85.A5.E5.8F.A3"><span class="tocnumber">4.2.4</span> <span class="toctext">活用自定义入口</span></a></li> 
              </ul> </li> 
             <li class="toclevel-2 tocsection-11"><a href="#.E6.8E.A5.E5.8F.A3.E8.B0.83.E7.94.A8.E6.B5.81.E7.A8.8B"><span class="tocnumber">4.3</span> <span class="toctext">接口调用流程</span></a></li> 
             <li class="toclevel-2 tocsection-12"><a href="#API.E5.88.97.E8.A1.A8"><span class="tocnumber">4.4</span> <span class="toctext">API列表</span></a></li> 
             <li class="toclevel-2 tocsection-13"><a href="#API.E8.AF.A6.E6.83.85"><span class="tocnumber">4.5</span> <span class="toctext">API详情</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-14"><a href="#.E4.B8.8A.E4.BC.A0.E5.9B.BE.E7.89.87.E6.8E.A5.E5.8F.A3"><span class="tocnumber">4.5.1</span> <span class="toctext">上传图片接口</span></a></li> 
               <li class="toclevel-3 tocsection-15"><a href="#.E5.BE.AE.E4.BF.A1.E9.97.A8.E5.BA.97.E6.8E.A5.E5.8F.A3"><span class="tocnumber">4.5.2</span> <span class="toctext">微信门店接口</span></a></li> 
               <li class="toclevel-3 tocsection-16"><a href="#.E9.80.89.E5.8F.96.E5.8D.A1.E5.88.B8.E8.83.8C.E6.99.AF.E8.89.B2"><span class="tocnumber">4.5.3</span> <span class="toctext">选取卡券背景色</span></a></li> 
               <li class="toclevel-3 tocsection-17"><a href="#.E5.88.9B.E5.BB.BA.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.8E.A5.E5.8F.A3"><span class="tocnumber">4.5.4</span> <span class="toctext">创建朋友的券接口</span></a></li> 
               <li class="toclevel-3 tocsection-18"><a href="#.E5.AE.A1.E6.A0.B8.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><span class="tocnumber">4.5.5</span> <span class="toctext">审核事件推送</span></a></li> 
               <li class="toclevel-3 tocsection-19"><a href="#.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.94.AF.E6.8C.81.E4.B9.B0.E5.8D.95"><span class="tocnumber">4.5.6</span> <span class="toctext">朋友的券支持买单</span></a></li> 
              </ul> </li> 
             <li class="toclevel-2 tocsection-20"><a href="#.E5.B8.AE.E5.8A.A9"><span class="tocnumber">4.6</span> <span class="toctext">帮助</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-21"><a href="#.E9.94.99.E8.AF.AF.E7.A0.81"><span class="tocnumber">4.6.1</span> <span class="toctext">错误码</span></a></li> 
               <li class="toclevel-3 tocsection-22"><a href="#.E5.B8.B8.E8.A7.81.E9.97.AE.E9.A2.98"><span class="tocnumber">4.6.2</span> <span class="toctext">常见问题</span></a></li> 
              </ul> </li> 
            </ul> </li> 
           <li class="toclevel-1 tocsection-23"><a href="#.E9.85.8D.E7.BD.AE.E5.BA.93.E5.AD.98.E3.80.81.E5.85.85.E5.80.BC.E5.88.B8.E7.82.B9"><span class="tocnumber">5</span> <span class="toctext">配置库存、充值券点</span></a> 
            <ul> 
             <li class="toclevel-2 tocsection-24"><a href="#.E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E"><span class="tocnumber">5.1</span> <span class="toctext">接口说明</span></a></li> 
             <li class="toclevel-2 tocsection-25"><a href="#.E6.8E.A5.E5.8F.A3.E8.B0.83.E7.94.A8.E6.B5.81.E7.A8.8B_2"><span class="tocnumber">5.2</span> <span class="toctext">接口调用流程</span></a></li> 
             <li class="toclevel-2 tocsection-26"><a href="#API.E5.88.97.E8.A1.A8_2"><span class="tocnumber">5.3</span> <span class="toctext">API列表</span></a></li> 
             <li class="toclevel-2 tocsection-27"><a href="#API.E8.AF.A6.E6.83.85_2"><span class="tocnumber">5.4</span> <span class="toctext">API详情</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-28"><a href="#.E5.BC.80.E9.80.9A.E5.88.B8.E7.82.B9.E8.B4.A6.E6.88.B7.E6.8E.A5.E5.8F.A3"><span class="tocnumber">5.4.1</span> <span class="toctext">开通券点账户接口</span></a></li> 
               <li class="toclevel-3 tocsection-29"><a href="#.E5.AF.B9.E4.BC.98.E6.83.A0.E5.88.B8.E6.89.B9.E4.BB.B7"><span class="tocnumber">5.4.2</span> <span class="toctext">对优惠券批价</span></a></li> 
               <li class="toclevel-3 tocsection-30"><a href="#.E6.9F.A5.E8.AF.A2.E5.88.B8.E7.82.B9.E4.BD.99.E9.A2.9D.E6.8E.A5.E5.8F.A3"><span class="tocnumber">5.4.3</span> <span class="toctext">查询券点余额接口</span></a></li> 
               <li class="toclevel-3 tocsection-31"><a href="#.E7.A1.AE.E8.AE.A4.E5.85.91.E6.8D.A2.E5.BA.93.E5.AD.98.E6.8E.A5.E5.8F.A3"><span class="tocnumber">5.4.4</span> <span class="toctext">确认兑换库存接口</span></a></li> 
               <li class="toclevel-3 tocsection-32"><a href="#.E5.85.85.E5.80.BC.E5.88.B8.E7.82.B9.E6.8E.A5.E5.8F.A3"><span class="tocnumber">5.4.5</span> <span class="toctext">充值券点接口</span></a></li> 
               <li class="toclevel-3 tocsection-33"><a href="#.E6.9F.A5.E8.AF.A2.E8.AE.A2.E5.8D.95.E8.AF.A6.E6.83.85.E6.8E.A5.E5.8F.A3"><span class="tocnumber">5.4.6</span> <span class="toctext">查询订单详情接口</span></a></li> 
               <li class="toclevel-3 tocsection-34"><a href="#.E6.9F.A5.E8.AF.A2.E5.88.B8.E7.82.B9.E6.B5.81.E6.B0.B4.E8.AF.A6.E6.83.85.E6.8E.A5.E5.8F.A3"><span class="tocnumber">5.4.7</span> <span class="toctext">查询券点流水详情接口</span></a></li> 
               <li class="toclevel-3 tocsection-35"><a href="#.E5.88.B8.E7.82.B9.E6.B5.81.E6.B0.B4.E8.AF.A6.E6.83.85.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><span class="tocnumber">5.4.8</span> <span class="toctext">券点流水详情事件推送</span></a></li> 
              </ul> </li> 
            </ul> </li> 
           <li class="toclevel-1 tocsection-36"><a href="#.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.8A.95.E6.94.BE"><span class="tocnumber">6</span> <span class="toctext">朋友的券投放</span></a> 
            <ul> 
             <li class="toclevel-2 tocsection-37"><a href="#.E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E_2"><span class="tocnumber">6.1</span> <span class="toctext">接口说明</span></a></li> 
             <li class="toclevel-2 tocsection-38"><a href="#.E5.BC.80.E5.8F.91.E8.80.85.E6.B3.A8.E6.84.8F.E4.BA.8B.E9.A1.B9_2"><span class="tocnumber">6.2</span> <span class="toctext">开发者注意事项</span></a></li> 
             <li class="toclevel-2 tocsection-39"><a href="#.E6.A1.88.E4.BE.8B.E4.BB.8B.E7.BB.8D"><span class="tocnumber">6.3</span> <span class="toctext">案例介绍</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-40"><a href="#.E5.8D.A1.E5.88.B8.E4.BA.8C.E7.BB.B4.E7.A0.81.E6.8A.95.E6.94.BE"><span class="tocnumber">6.3.1</span> <span class="toctext">卡券二维码投放</span></a> 
                <ul> 
                 <li class="toclevel-4 tocsection-41"><a href="#.E5.9C.BA.E6.99.AF.E4.BB.8B.E7.BB.8D"><span class="tocnumber">6.3.1.1</span> <span class="toctext">场景介绍</span></a></li> 
                 <li class="toclevel-4 tocsection-42"><a href="#.E4.BD.BF.E7.94.A8.E6.B5.81.E7.A8.8B"><span class="tocnumber">6.3.1.2</span> <span class="toctext">使用流程</span></a></li> 
                 <li class="toclevel-4 tocsection-43"><a href="#API.E5.88.97.E8.A1.A8_3"><span class="tocnumber">6.3.1.3</span> <span class="toctext">API列表</span></a></li> 
                </ul> </li> 
               <li class="toclevel-3 tocsection-44"><a href="#H5.E7.BD.91.E9.A1.B5.E6.8A.95.E6.94.BE"><span class="tocnumber">6.3.2</span> <span class="toctext">H5网页投放</span></a> 
                <ul> 
                 <li class="toclevel-4 tocsection-45"><a href="#.E5.9C.BA.E6.99.AF.E4.BB.8B.E7.BB.8D_2"><span class="tocnumber">6.3.2.1</span> <span class="toctext">场景介绍</span></a></li> 
                 <li class="toclevel-4 tocsection-46"><a href="#.E6.8E.A5.E5.8F.A3.E8.B0.83.E7.94.A8.E6.B5.81.E7.A8.8B_3"><span class="tocnumber">6.3.2.2</span> <span class="toctext">接口调用流程</span></a></li> 
                 <li class="toclevel-4 tocsection-47"><a href="#API.E5.88.97.E8.A1.A8_4"><span class="tocnumber">6.3.2.3</span> <span class="toctext">API列表</span></a></li> 
                </ul> </li> 
              </ul> </li> 
             <li class="toclevel-2 tocsection-48"><a href="#API.E8.AF.A6.E6.83.85_3"><span class="tocnumber">6.4</span> <span class="toctext">API详情</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-49"><a href="#.E8.AE.BE.E7.BD.AE.E6.B5.8B.E8.AF.95.E7.99.BD.E5.90.8D.E5.8D.95.E6.8E.A5.E5.8F.A3"><span class="tocnumber">6.4.1</span> <span class="toctext">设置测试白名单接口</span></a></li> 
               <li class="toclevel-3 tocsection-50"><a href="#.E7.94.9F.E6.88.90.E4.BA.8C.E7.BB.B4.E7.A0.81.E6.8E.A5.E5.8F.A3"><span class="tocnumber">6.4.2</span> <span class="toctext">生成二维码接口</span></a></li> 
               <li class="toclevel-3 tocsection-51"><a href="#.E8.8E.B7.E5.8F.96JSAPI_TICKET.E6.8E.A5.E5.8F.A3"><span class="tocnumber">6.4.3</span> <span class="toctext">获取JSAPI_TICKET接口</span></a></li> 
               <li class="toclevel-3 tocsection-52"><a href="#.E8.8E.B7.E5.8F.96.E5.8D.A1.E5.88.B8API_TICKET.E6.8E.A5.E5.8F.A3"><span class="tocnumber">6.4.4</span> <span class="toctext">获取卡券API_TICKET接口</span></a></li> 
               <li class="toclevel-3 tocsection-53"><a href="#.E6.89.B9.E9.87.8F.E6.B7.BB.E5.8A.A0.E5.8D.A1.E5.88.B8.EF.BC.88addcard.EF.BC.89.E6.8E.A5.E5.8F.A3"><span class="tocnumber">6.4.5</span> <span class="toctext">批量添加卡券（addcard）接口</span></a></li> 
               <li class="toclevel-3 tocsection-54"><a href="#.E5.8D.A1.E5.88.B8.E9.A2.86.E5.8F.96.E4.BA.8B.E4.BB.B6"><span class="tocnumber">6.4.6</span> <span class="toctext">卡券领取事件</span></a></li> 
              </ul> </li> 
             <li class="toclevel-2 tocsection-55"><a href="#.E5.B8.AE.E5.8A.A9_2"><span class="tocnumber">6.5</span> <span class="toctext">帮助</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-56"><a href="#.E9.94.99.E8.AF.AF.E7.A0.81_2"><span class="tocnumber">6.5.1</span> <span class="toctext">错误码</span></a></li> 
               <li class="toclevel-3 tocsection-57"><a href="#.E5.B8.B8.E8.A7.81.E9.97.AE.E9.A2.98_2"><span class="tocnumber">6.5.2</span> <span class="toctext">常见问题</span></a></li> 
              </ul> </li> 
            </ul> </li> 
           <li class="toclevel-1 tocsection-58"><a href="#.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.A0.B8.E9.94.80"><span class="tocnumber">7</span> <span class="toctext">朋友的券核销</span></a> 
            <ul> 
             <li class="toclevel-2 tocsection-59"><a href="#.E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E_3"><span class="tocnumber">7.1</span> <span class="toctext">接口说明</span></a></li> 
             <li class="toclevel-2 tocsection-60"><a href="#.E6.A1.88.E4.BE.8B.E4.BB.8B.E7.BB.8D_2"><span class="tocnumber">7.2</span> <span class="toctext">案例介绍</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-61"><a href="#.E7.BA.BF.E4.B8.8B.E6.A0.B8.E9.94.80"><span class="tocnumber">7.2.1</span> <span class="toctext">线下核销</span></a> 
                <ul> 
                 <li class="toclevel-4 tocsection-62"><a href="#.E6.9C.BA.E5.85.B7.E6.89.AB.E7.A0.81.E6.A0.B8.E9.94.80"><span class="tocnumber">7.2.1.1</span> <span class="toctext">机具扫码核销</span></a></li> 
                 <li class="toclevel-4 tocsection-63"><a href="#.E7.BD.91.E9.A1.B5.E5.B7.A5.E5.85.B7.E6.A0.B8.E9.94.80"><span class="tocnumber">7.2.1.2</span> <span class="toctext">网页工具核销</span></a></li> 
                 <li class="toclevel-4 tocsection-64"><a href="#.E5.8D.A1.E5.88.B8.E5.95.86.E6.88.B7.E5.8A.A9.E6.89.8B.E6.A0.B8.E9.94.80"><span class="tocnumber">7.2.1.3</span> <span class="toctext">卡券商户助手核销</span></a></li> 
                 <li class="toclevel-4 tocsection-65"><a href="#.E5.85.AC.E4.BC.97.E5.8F.B7.E5.95.86.E6.88.B7.E5.90.8E.E5.8F.B0.E6.A0.B8.E9.94.80"><span class="tocnumber">7.2.1.4</span> <span class="toctext">公众号商户后台核销</span></a></li> 
                </ul> </li> 
               <li class="toclevel-3 tocsection-66"><a href="#.E7.BA.BF.E4.B8.8A.E6.A0.B8.E9.94.80"><span class="tocnumber">7.2.2</span> <span class="toctext">线上核销</span></a> 
                <ul> 
                 <li class="toclevel-4 tocsection-67"><a href="#.E7.BD.91.E9.A1.B5.E5.BF.AB.E9.80.9F.E6.A0.B8.E9.94.80"><span class="tocnumber">7.2.2.1</span> <span class="toctext">网页快速核销</span></a></li> 
                </ul> </li> 
              </ul> </li> 
             <li class="toclevel-2 tocsection-68"><a href="#API.E8.AF.A6.E6.83.85_4"><span class="tocnumber">7.3</span> <span class="toctext">API详情</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-69"><a href="#.E6.9F.A5.E8.AF.A2Code.E6.8E.A5.E5.8F.A3"><span class="tocnumber">7.3.1</span> <span class="toctext">查询Code接口</span></a></li> 
               <li class="toclevel-3 tocsection-70"><a href="#.E6.8B.89.E5.8F.96.E5.8D.A1.E5.88.B8.E5.88.97.E8.A1.A8.28ChooseCard.29.E6.8E.A5.E5.8F.A3"><span class="tocnumber">7.3.2</span> <span class="toctext">拉取卡券列表(ChooseCard)接口</span></a></li> 
               <li class="toclevel-3 tocsection-71"><a href="#.E8.8E.B7.E5.8F.96.E8.87.AA.E5.AE.9A.E4.B9.89.E5.A4.96.E9.93.BE.E5.8F.82.E6.95.B0"><span class="tocnumber">7.3.3</span> <span class="toctext">获取自定义外链参数</span></a></li> 
               <li class="toclevel-3 tocsection-72"><a href="#Code.E8.A7.A3.E7.A0.81.E6.8E.A5.E5.8F.A3"><span class="tocnumber">7.3.4</span> <span class="toctext">Code解码接口</span></a></li> 
               <li class="toclevel-3 tocsection-73"><a href="#Mark.28.E5.8D.A0.E7.94.A8.29Code.E6.8E.A5.E5.8F.A3"><span class="tocnumber">7.3.5</span> <span class="toctext">Mark(占用)Code接口</span></a></li> 
               <li class="toclevel-3 tocsection-74"><a href="#.E7.BA.BF.E4.B8.8B.E6.A0.B8.E9.94.80Code.E6.8E.A5.E5.8F.A3"><span class="tocnumber">7.3.6</span> <span class="toctext">线下核销Code接口</span></a></li> 
               <li class="toclevel-3 tocsection-75"><a href="#.E7.BA.BF.E4.B8.8A.E6.A0.B8.E9.94.80Code.E6.8E.A5.E5.8F.A3"><span class="tocnumber">7.3.7</span> <span class="toctext">线上核销Code接口</span></a></li> 
               <li class="toclevel-3 tocsection-76"><a href="#.E6.A0.B8.E9.94.80.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><span class="tocnumber">7.3.8</span> <span class="toctext">核销事件推送</span></a></li> 
               <li class="toclevel-3 tocsection-77"><a href="#.E6.A0.B8.E9.94.80.E5.90.8E.E5.86.8D.E6.AC.A1.E8.B5.A0.E9.80.81.E5.8D.A1.E5.88.B8.E6.8E.A5.E5.8F.A3.EF.BC.88JS_SDK.EF.BC.89"><span class="tocnumber">7.3.9</span> <span class="toctext">核销后再次赠送卡券接口（JS SDK）</span></a></li> 
              </ul> </li> 
             <li class="toclevel-2 tocsection-78"><a href="#.E5.B8.AE.E5.8A.A9_3"><span class="tocnumber">7.4</span> <span class="toctext">帮助</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-79"><a href="#.E9.94.99.E8.AF.AF.E7.A0.81_3"><span class="tocnumber">7.4.1</span> <span class="toctext">错误码</span></a></li> 
               <li class="toclevel-3 tocsection-80"><a href="#.E5.B8.B8.E8.A7.81.E9.97.AE.E9.A2.98_3"><span class="tocnumber">7.4.2</span> <span class="toctext">常见问题</span></a></li> 
              </ul> </li> 
            </ul> </li> 
           <li class="toclevel-1 tocsection-81"><a href="#.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E7.AE.A1.E7.90.86.E6.8E.A5.E5.8F.A3"><span class="tocnumber">8</span> <span class="toctext">朋友的券管理接口</span></a> 
            <ul> 
             <li class="toclevel-2 tocsection-82"><a href="#.E6.9B.B4.E6.96.B0.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E4.BF.A1.E6.81.AF.E6.8E.A5.E5.8F.A3"><span class="tocnumber">8.1</span> <span class="toctext">更新朋友的券信息接口</span></a></li> 
             <li class="toclevel-2 tocsection-83"><a href="#.E6.8B.89.E5.8F.96.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><span class="tocnumber">8.2</span> <span class="toctext">拉取朋友的券数据接口</span></a> 
              <ul> 
               <li class="toclevel-3 tocsection-84"><a href="#.E6.8B.89.E5.8F.96.E5.8D.A1.E5.88.B8.E6.A6.82.E5.86.B5.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><span class="tocnumber">8.2.1</span> <span class="toctext">拉取卡券概况数据接口</span></a></li> 
               <li class="toclevel-3 tocsection-85"><a href="#.E8.8E.B7.E5.8F.96.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><span class="tocnumber">8.2.2</span> <span class="toctext">获取朋友的券数据接口</span></a></li> 
              </ul> </li> 
            </ul> </li> 
           <li class="toclevel-1 tocsection-86"><a href="#.E6.88.91.E6.98.AF.E7.AC.AC.E4.B8.89.E6.96.B9.E5.BC.80.E5.8F.91.E8.80.85.2F.E6.9C.8D.E5.8A.A1.E5.95.86"><span class="tocnumber">9</span> <span class="toctext">我是第三方开发者/服务商</span></a></li> 
           <li class="toclevel-1 tocsection-87"><a href="#.E4.BA.A4.E6.B5.81.E5.8F.8D.E9.A6.88"><span class="tocnumber">10</span> <span class="toctext">交流反馈</span></a></li> 
          </ul> </td>
        </tr>
       </tbody>
      </table> 
      <h1> <span class="mw-headline" id=".E6.9B.B4.E6.96.B0.E6.97.A5.E5.BF.97"> 更新日志 </span></h1> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">版本号 </th> 
         <th>更新内容 </th> 
         <th>更新时间 </th>
        </tr> 
        <tr> 
         <td> V1.1 </td> 
         <td> 1.限制共享券代金券类型标题传入，统一命名为xxx元代金券，xxx为减免金额字段；<br>2.礼品券更名为兑换券，限制标题传入，统一命名为：洗手液(商品名)+1(数量)+瓶（数量单位），对应gift_name,gift_num,和gift_unit字段。 </td> 
         <td> 2015-12-2 </td>
        </tr> 
        <tr> 
         <td> V1.2 </td> 
         <td> 1.新增朋友的券白名单接口，支持领取共享未通过审核的共享券，仅限白名单list内用户可见。<br>2.新增朋友的券测试沙箱机制，未在开放类目内的开发者可以通过沙箱测试号测试创建、领取共享券<br>3.新增接口充值库存、券点系列接口，开发者可以通过接口完成库存、券点的充值和管理。<br>4.支持接口创建有门槛朋友的券，目前支持“满减券”、“指定品类券”和“不与其他优惠共享”类型门槛。 </td> 
         <td> 2015-12-27 </td>
        </tr> 
        <tr> 
         <td> V1.3 </td> 
         <td> 1.根据开发者填入的不同门槛，卡券标题拼接方案变更；<br>2.支持开发者填入使用时段限制，比如：周一 10：00-20:59可用；周一至周五 10：00-20:59可用 </td> 
         <td> 2016-2-16 </td>
        </tr> 
       </tbody>
      </table> 
      <h1> <span class="mw-headline" id=".E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E7.AE.80.E4.BB.8B">朋友的券简介</span></h1> 
      <p>“朋友共享的优惠券”（以下简称“朋友的券”），是基于微信优惠券推出的新功能，实现“一人领取多人共享”的快速社交传播和转化的效果。 </p>
      <p>领取并与朋友共享此券，券会自动展示在领取人及其朋友的优惠券列表中，领取人及其朋友均可使用此券。商户可选择赠送配置：当朋友的券被使用后,根据商户配置的赠送量,使用者将立即获赠一张朋友的券,继续与朋友共享此券。 </p>
      <p><br> <a href="#" class="image"><img alt="朋友的券02.PNG" src="../static/assets/bbb5ad69d248a087fc9039ca0af1b662.jpg" width="603" height="784"></a> </p>
      <p><b>朋友的券的优势</b> </p>
      <p>1、高曝光量：朋友的券被领取后，将自动展示在领取者及其朋友的微信优惠券里，曝光量得到大幅提升。 </p>
      <p>2、高转化率：一张优惠券，传统玩法下只曝光至一个用户，朋友的券新玩法下可以曝光至领取者及其朋友们；同样的预算成本，得到更大量的曝光，转化率、收益也会得到有效提升。 </p>
      <p>3、朋友推荐： 优惠经过领取者认可后才会被共享给朋友们，该朋友的券的价值有领取者的背书，更值得信赖；同时微信朋友间的相似喜好，可以进一步提高朋友的券的转化率。 </p>
      <p>4、裂变：朋友的券被用户或其朋友核销后，商家可以立即再次赠送优惠券供使用者领取共享，且赠券仍为朋友的券。这让商家的优惠在用户中得到持续的曝光。 </p>
      <p><b>开放对象</b> </p>
      <p>朋友的券将按照卡券商户的类目逐步开放，首批开放朋友的券功能的商户类目如下。后续将向更多类目商户逐步开放，请关注微信公众平台公告。 </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:200px">一级类目 </th> 
         <th>二级内容 </th>
        </tr> 
        <tr> 
         <td> 美食 </td> 
         <td> 粤菜、茶餐厅、川菜、湘菜、东北菜、西北菜、火锅、自助餐、小吃、快餐、日本料理、韩国料理、东南亚菜、西餐、面包甜点、咖 <p>啡厅、江浙菜、其它美食、外卖 </p> </td>
        </tr> 
        <tr> 
         <td> 休闲娱乐 </td> 
         <td> 展览展出、温泉洗浴、足疗按摩、运动健身、棋牌室、KTV、酒吧/俱乐部、艺术写真、宠物美容、美容美发、美甲 </td>
        </tr> 
        <tr> 
         <td> 生活服务 </td> 
         <td> 快递、宠物医疗、物业管理、家政服务、养生养护 </td>
        </tr> 
        <tr> 
         <td> 电影票 </td> 
         <td> 电影票 </td>
        </tr> 
        <tr> 
         <td> 酒店 </td> 
         <td> 快捷酒店、度假村、星级酒店 </td>
        </tr> 
        <tr> 
         <td> 购物 </td> 
         <td> 母婴用品、普通食品、鲜花礼品、家纺家装、钟表眼镜、日护用品、化妆品、运动户外、鞋类箱包、服饰、副食品门市、超市/便利店、购物中心/购物街、百货商场 </td>
        </tr> 
        <tr> 
         <td> 生活服务 </td> 
         <td> 婚庆服务、加油站、汽车维修、汽车驾校 </td>
        </tr> 
        <tr> 
         <td>旅游 </td> 
         <td>景点门票 </td>
        </tr> 
        <tr> 
         <td>购物 </td> 
         <td>便利店、珠宝配饰、家居、建材五金/机械仪表、乐器、酒类、药房/药店、图书报刊杂志、数码家电 </td>
        </tr> 
        <tr> 
         <td>运输票务 </td> 
         <td>机票、船票、车票 </td>
        </tr> 
       </tbody>
      </table> 
      <p>若开发者的公众号未在开放类目内，开发者可以<a href="../10/597cb57750f375a4b37e2536fd3331ea.html#.E5.8D.A1.E5.88.B8.E6.B5.8B.E8.AF.95.E6.B2.99.E7.AE.B1.E6.9C.BA.E5.88.B6" class="external text" rel="nofollow">申请沙箱测试号</a>进行创建、领取、投放、核销等流程，沙箱测试号具有朋友的券创建权限，创建的卡券不会被审核通过，开发者可以通过<a href="../5/f942979ef2f0d313d4d36e3a26766a3d.html#.E8.AE.BE.E7.BD.AE.E6.B5.8B.E8.AF.95.E7.99.BD.E5.90.8D.E5.8D.95" class="external text" rel="nofollow">设置接口白名单</a>领取未审核通过的券，共享后仅白名单list内的好友可见。 </p>
      <p><b>特别说明</b> </p>
      <p>优惠券共享的玩法，将极大地提升优惠券的曝光量和使用率。优惠券使用后，会引入好友互动，增加社交趣味性。特别地，朋友共享的优惠券，需要满足以下要求 </p>
      <p>1、选择起用金额为0元的无门槛代金券或无门槛兑换券，或选择指定门槛类型的代金券或者兑换券，目前支持的门槛类型为：满减门槛（满xxx可用）、指定品类门槛（指定xxx可用/不可用）以及不与其他优惠共享门槛，详情请见<a href="../10/333958907c5aae0581e93a24f2df8562.html#.E9.80.89.E6.8B.A9.E5.90.88.E9.80.82.E7.9A.84.E9.97.A8.E6.A7.9B.E7.B1.BB.E5.9E.8B" class="external text" rel="nofollow">选择朋友的券门槛</a>； </p>
      <p>2、需要设置图文介绍的优惠详情（advanced_info字段）； </p>
      <p>3、可选择每核销使用1张优惠券，再送用户1张； </p>
      <p>4、暂不支持商家自定义Code码（<a href="../15/e33671f4ef511b77755142b37502928f.html#.E6.98.AF.E5.90.A6.E8.87.AA.E5.AE.9A.E4.B9.89Code.E7.A0.81" class="external text" rel="nofollow">什么是Code码？</a>）； </p> 
      <h1> <span class="mw-headline" id=".E5.BC.80.E5.8F.91.E8.80.85.E6.B3.A8.E6.84.8F.E4.BA.8B.E9.A1.B9">开发者注意事项</span></h1> 
      <p>要开发朋友的券，开发者需要完成以下开发步骤： </p>
      <p>1、登录【微信公众平台后台】，点击【卡券功能】或者调用<a href="../10/333958907c5aae0581e93a24f2df8562.html#.E5.BC.80.E9.80.9A.E5.88.B8.E7.82.B9.E8.B4.A6.E6.88.B7.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">开通券点账户接口</a>开通朋友的券券点账户，目前商户后台该开通入口仅针对指定类目商户开放，如还没发现入口开发者可以先耐心等待，后续会逐步放开； </p>
      <p>2、创建优惠券：其中先准备好LOGO、门店、色值等内容，然后使用创建接口，创建起用金额为0元的代金券，并填入图文介绍，设置每核销1张，再赠送用户1张，得到card_id，此部分参考<a href="../10/333958907c5aae0581e93a24f2df8562.html#.E5.88.9B.E5.BB.BA.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8" class="external text" rel="nofollow">创建朋友的券</a>； </p>
      <p>3、调用<a href="../10/333958907c5aae0581e93a24f2df8562.html#.E9.85.8D.E7.BD.AE.E5.BA.93.E5.AD.98.E3.80.81.E5.85.85.E5.80.BC.E5.88.B8.E7.82.B9" class="external text" rel="nofollow">兑换库存、充值券点系列接口</a>为优惠券配置库存，为账号充值券点。 </p>
      <p>4、投放朋友的券：设置库存后，开发者可以取card_id通过生成二维码或者扫码打开的H5投放，同时也可以通过微信摇一摇或者微信WIFI渠道打开的H5投放卡券，用户扫码即可共享此券，此部分可参考<a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.8A.95.E6.94.BE" class="external text" rel="nofollow">投放朋友的券</a>。 </p>
      <p>若卡券未通过审核，开发者可以通过<a href="../5/f942979ef2f0d313d4d36e3a26766a3d.html#.E8.AE.BE.E7.BD.AE.E6.B5.8B.E8.AF.95.E7.99.BD.E5.90.8D.E5.8D.95" class="external text" rel="nofollow">设置白名单接口</a>设置接口白名单领取未审核通过的优惠券并共享，共享后仅接口白名单内的好友可见。 </p>
      <p>5、核销朋友的券：共享的用户及其好友，可以看到此券，到店出示享受优惠，使用后再获得赠送的卡券继续和好友共享，此部分开发者须使用核销助手或开发核销工具帮助商户核销，可参考<a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.A0.B8.E9.94.80" class="external text" rel="nofollow">核销朋友的券</a>。 </p>
      <p>6、管理朋友的券：开发者在卡券投放发布后可对卡券信息进行修改或统计卡券数据，可参考<a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E7.AE.A1.E7.90.86.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">管理朋友的券</a> </p> 
      <h1> <span class="mw-headline" id=".E5.88.9B.E5.BB.BA.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8">创建朋友的券</span></h1> 
      <h2> <span class="mw-headline" id=".E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.A0.B7.E5.BC.8F"><b>朋友的券样式</b></span></h2> 
      <p>朋友的券较之前的样式有较大改变，卡券背景色更加突出，强调券的整洁和美观的同时将商户元素更加有强调性地展示，同时支持图文介绍传入，给了商户更大的曝光空间。 </p>
      <p><a href="#" class="image"><img alt="卡券样式.png" src="../static/assets/2343b0b7445b697e8cfe167bb37b725a.png" width="603" height="502"></a> </p> 
      <h2> <span class="mw-headline" id=".E6.8E.A5.E5.8F.A3.E8.B0.83.E7.94.A8.E8.AF.B4.E6.98.8E"><b>接口调用说明</b></span></h2> 
      <p>创建卡券是卡券开发的第一步，开发者需要传入优惠内容生成一个card_id，并在通过审核后进行投放、核销等动作。在进行卡券创建前，请开发者根据自身业务场景确定以下几点 </p> 
      <h3> <span class="mw-headline" id=".E9.80.89.E6.8B.A9.E5.90.88.E9.80.82.E7.9A.84.E9.97.A8.E6.A7.9B.E7.B1.BB.E5.9E.8B"><b>选择合适的门槛类型</b></span></h3> 
      <p>目前朋友的券支持无门槛类型以及指定门槛类型的代金券、兑换券，微信后台会根据商户填写的门槛类型自动拼接卡券的<a href="../10/333958907c5aae0581e93a24f2df8562.html#.E5.88.9B.E5.BB.BA.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">详情摘要字段</a>和<a href="../10/333958907c5aae0581e93a24f2df8562.html#.E5.88.9B.E5.BB.BA.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">卡券标题</a>字段，开发者可以根据需求选择合适的门槛类型组合，获得最佳的发券效果。 </p>
      <p>商户按照指定字段填写门槛有利于优惠券审核快速通过，若商户填写了非以下类型的门槛，优惠券将不会被审核通过。 </p>
      <p>同时，微信后台会根据卡券选择的门槛不同而设置不同的库存价格，目前定价标准为： </p> 
      <pre>   1） 无门槛类型，保持0.2券点/张；
   2） 指定品类可用/不可用门槛，0.4券点/张；
   3） 满减/买xx可用门槛，0.6券点/张；
   4） 不与其他优惠共享共享门槛，0.8券点/张。
</pre> 
      <p>更多详情请以<a href="https://mp.weixin.qq.com/cgi-bin/readtemplate?t=cardticket/faq_tmpl&amp;type=info&amp;token=912741416&amp;lang=zh_CN#1dot3" class="external text" rel="nofollow">朋友的券收费标准</a>为准。 </p>
      <p><b>不同门槛类型的字段以及展现</b> </p>
      <p>微信后台会根据开发者填入不同的门槛字段决定券的样式和展现，下面以一张50元代金券和兑换蛋挞一个的兑换券说明不同门槛带来的 展现逻辑变化。 </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">门槛类型 </th> 
         <th>适用券种 </th> 
         <th>设置条件 </th> 
         <th>详情摘要 </th> 
         <th>标题 </th>
        </tr> 
        <tr> 
         <td>无门槛 </td> 
         <td>代金券/兑换券 </td> 
         <td>不填入任何门槛字段 </td> 
         <td>无起用金额限制，全场通用，不限品类 </td> 
         <td>50元代金券/苹果一个 </td>
        </tr> 
        <tr> 
         <td>指定品类可用/不可用门槛 </td> 
         <td>代金券 </td> 
         <td>填入accept_category（蛋挞）和reject_category（蛋糕）字段 </td> 
         <td>适用于蛋挞，不适用于蛋糕 </td> 
         <td>蛋挞减50元（填入的accept_catagory小于等于5个汉字）；50元代金券（填入的accept_catagory大于5个汉字） </td>
        </tr> 
        <tr> 
         <td>满减门槛 </td> 
         <td>代金券/兑换券 </td> 
         <td>填入least_cost（500）字段 </td> 
         <td>消费满500元可用 </td> 
         <td>全场满500减50 </td>
        </tr> 
        <tr> 
         <td>买送门槛（限兑换券） </td> 
         <td>兑换券 </td> 
         <td>填入object_use_for字段 </td> 
         <td>购买蛋糕可用 </td> 
         <td>买蛋糕送蛋挞 </td>
        </tr> 
        <tr> 
         <td>不与其他优惠共享门槛 </td> 
         <td>代金券/兑换券 </td> 
         <td>填入can_share_with_other_discount<br>（false）字段 </td> 
         <td>不与其他优惠共享 </td> 
         <td>50元代金券 </td>
        </tr> 
       </tbody>
      </table> 
      <p>注意： </p>
      <p>1.门槛字段用于拼接标题以及优惠说明，会影响商户卡券库存定价，请开发者务必按照要求填写，并提前预览生成的卡券；<br> 2.门槛字段一旦设定即不可更改，请开发者慎重填写，及时预览。<br> 3.当开发者同时填入满减字段和指定品类可用字段，则会拼接为"羽绒服（accept_catagory字段小于等于5个字）满500减50"，"满500减50"（accept_catagory字段大于5个字） </p> 
      <h3> <span class="mw-headline" id=".E9.80.89.E6.8B.A9.E5.90.88.E9.80.82.E7.9A.84code.E6.98.BE.E7.A4.BA.E7.B1.BB.E5.9E.8B"><b>选择合适的code显示类型</b></span></h3> 
      <p>目前卡券支持五种code显示类型：即二维码显示code、二维码不显示code、一维码显示code、仅code类型和无code类型（仅限支持券）。 </p>
      <p>对于不同的code类型，需要的核销方式也不同，对于显示二维码和一维码的卡券可以采用扫码核销的方式，对于只显示code类型的卡券适合用输码核销的方式，而无code类型的优惠券，则仅适合用于线上券使用，并且商户需开发自定义页面供用户核销卡券。 </p>
      <p>不同的code类型，开发者在创建券时须传入不同的code_type参数。 </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">类别 </th> 
         <th>字段名 </th> 
         <th>适用核销方式 </th>
        </tr> 
        <tr> 
         <td>二维码/一维码显示code </td> 
         <td>CODE_TYPE_QRCODE/CODE_TYPE_BARCODE </td> 
         <td>适用于扫码/输码核销 </td>
        </tr> 
        <tr> 
         <td>二维码不显示code </td> 
         <td>CODE_TYPE_ONLY_QRCODE </td> 
         <td>仅适用于扫码核销 </td>
        </tr> 
        <tr> 
         <td>仅code类型 </td> 
         <td>CODE_TYPE_TEXT </td> 
         <td>仅适用于输码核销 </td>
        </tr> 
        <tr> 
         <td>无code类型 </td> 
         <td>CODE_TYPE_NONE </td> 
         <td>仅适用于线上核销，在券面不出现二维码展开入口 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E8.AE.B0.E5.BD.95.E7.94.A8.E6.88.B7.E9.A2.86.E5.88.B8.E8.A1.8C.E4.B8.BA"><b>记录用户领券行为</b></span></h3> 
      <p>记录用户领券行为有多种方式： </p>
      <p>1. 用户领取卡券后会推送事件通知开发者，领取卡券事件中包含卡券ID、Code码、领取人OpenID。卡券被核销时同样会推送事件，详情见<a href="../16/28b34ee91675a04cb24853768debded4.html#.E5.8D.A1.E5.88.B8.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81" class="external text" rel="nofollow">卡券事件推送</a>。 </p>
      <p>2. 调用<a href="../14/8dd77aeaee85f922db5f8aa6386d385e.html#.E6.9F.A5.E8.AF.A2Code.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">查询Code接口</a>获取该Code码的状态（是否被领取、核销、删除），若Code码被用户领取且处于有效状态，可获取领券人OpenID。 </p>
      <p>3. 从卡券详情页跳转外部链接时，微信后台会自动带上卡券ID、Code码等信息，详情见<a href="../15/e33671f4ef511b77755142b37502928f.html#.E8.B7.B3.E8.BD.AC.E5.A4.96.E9.93.BE.E5.B8.A6.E5.8F.82.E6.95.B0.E8.AF.B4.E6.98.8E" class="external text" rel="nofollow">跳转外链带参数说明</a>。 </p> 
      <h3> <span class="mw-headline" id=".E6.B4.BB.E7.94.A8.E8.87.AA.E5.AE.9A.E4.B9.89.E5.85.A5.E5.8F.A3"><b>活用自定义入口</b></span></h3> 
      <p>为满足商户功能扩展的需求，新增可自定义三个卡券内的入口，支持跳转到商户自定义url链接。 </p>
      <p><a href="#" class="image"><img alt="自定义入口图.png" src="../static/assets/8303d16311124ddc905ba25a5df8649a.png" width="524" height="522"></a> </p>
      <p>两个自定义入口基于不同的场景定位设置，区别如下： </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">类别 </th> 
         <th>示例 </th> 
         <th>字段 </th> 
         <th>显示逻辑 </th>
        </tr> 
        <tr> 
         <td>使用场景入口 </td> 
         <td>立即使用 </td> 
         <td>center_title、center_sub_title、center_url </td> 
         <td>传入后将覆盖二维码展开按钮，未到有效期时按钮置灰 </td>
        </tr> 
        <tr> 
         <td>服务场景入口 </td> 
         <td>在线商城 </td> 
         <td>custom_url_name、custom_url_sub_title、custom_url </td> 
         <td>仅卡券被用户领取且处于有效状态时显示（转赠中、核销后不显示）。 </td>
        </tr> 
        <tr> 
         <td>营销场景入口 </td> 
         <td>再次购买 </td> 
         <td>promotion_url_name、promotion_url_sub_title、promotion_url </td> 
         <td>卡券处于正常状态、转赠中、核销后等异常状态均显示该入口。 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id=".E6.8E.A5.E5.8F.A3.E8.B0.83.E7.94.A8.E6.B5.81.E7.A8.8B"><b>接口调用流程</b></span></h2> 
      <p>创建朋友的券请严格按照以下接口调用流程调用接口。 </p>
      <p><a href="#" class="image"><img alt="接口调用流程.png" src="../static/assets/20091e4ecdb10846142dbd5b08b92f30.png" width="691" height="213"></a> </p>
      <p>开发者须按照以上流程调用接口，接口列表如下表。 </p> 
      <h2> <span class="mw-headline" id="API.E5.88.97.E8.A1.A8"><b>API列表</b></span></h2> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:50px">步骤 </th> 
         <th>API名称 </th> 
         <th>用途 </th> 
         <th>API属性 </th>
        </tr> 
        <tr> 
         <td>1 </td> 
         <td><a href="../15/e33671f4ef511b77755142b37502928f.html#.E4.B8.8A.E4.BC.A0.E5.9B.BE.E7.89.87.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">上传图片接口</a> </td> 
         <td>上传卡券logo和卡券图片，获得url </td> 
         <td>基础接口 </td>
        </tr> 
        <tr> 
         <td>2 </td> 
         <td><a href="../15/e33671f4ef511b77755142b37502928f.html#.E6.AD.A5.E9.AA.A4.E4.B8.89.EF.BC.9A.E9.80.89.E5.8F.96.E5.8D.A1.E5.88.B8.E8.83.8C.E6.99.AF.E9.A2.9C.E8.89.B2" class="external text" rel="nofollow">选取卡券背景色</a> </td> 
         <td>获取卡券背景颜色色值colorid </td> 
         <td>创建卡券 </td>
        </tr> 
        <tr> 
         <td>3 </td> 
         <td><a href="../11/081986f089826bf94393bef9bf287b8b.html" class="external text" rel="nofollow">微信门店接口</a> </td> 
         <td>设置卡券门店并通过审核获得poiid，用于创建时填入location_list字段 </td> 
         <td>创建卡券 </td>
        </tr> 
        <tr> 
         <td>4 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E5.88.9B.E5.BB.BA.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">创建朋友的券接口</a> </td> 
         <td>创建卡券获得card_id用于增加库存、投放等动作 </td> 
         <td>创建卡券 </td>
        </tr> 
        <tr> 
         <td>5 </td> 
         <td><a href="../16/28b34ee91675a04cb24853768debded4.html#.E5.AE.A1.E6.A0.B8.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81" class="external text" rel="nofollow">审核事件推送</a> </td> 
         <td>获得审核结果 </td> 
         <td>卡券事件推送 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id="API.E8.AF.A6.E6.83.85"><b>API详情</b></span></h2> 
      <h3> <span class="mw-headline" id=".E4.B8.8A.E4.BC.A0.E5.9B.BE.E7.89.87.E6.8E.A5.E5.8F.A3"><b>上传图片接口</b></span></h3> 
      <p>请点击查看<a href="../15/e33671f4ef511b77755142b37502928f.html#.E4.B8.8A.E4.BC.A0.E5.9B.BE.E7.89.87.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">上传图片接口</a>，开发者需调用接口上传商家图标LOGO至微信服务器，获取相应logo_url，用于卡券创建。 </p>
      <p>注意事项： </p>
      <p>1.上传的图片限制文件大小限制1MB，支持JPG 格式。 </p>
      <p>2.调用接口获取的url 仅支持在微信相关业务下使用，否则会做相应处理。 </p>
      <p>3.此处必须上传微信服务器返回的图片链接，否则报错； </p> 
      <h3> <span class="mw-headline" id=".E5.BE.AE.E4.BF.A1.E9.97.A8.E5.BA.97.E6.8E.A5.E5.8F.A3"><b>微信门店接口</b></span></h3> 
      <p>请点击查看微信<a href="../11/081986f089826bf94393bef9bf287b8b.html#.E5.BE.AE.E4.BF.A1.E9.97.A8.E5.BA.97.E6.8E.A5.E5.8F.A3.E6.96.87.E6.A1.A3" class="external text" rel="nofollow">门店接口文档</a>，获取门店 ID 后填入创建卡券接口中的相应字段 location_id_list，即可设置该卡券的适用门店。 </p> 
      <h3> <span class="mw-headline" id=".E9.80.89.E5.8F.96.E5.8D.A1.E5.88.B8.E8.83.8C.E6.99.AF.E8.89.B2"><b>选取卡券背景色</b></span></h3> 
      <p>请点击查看 <a href="../15/e33671f4ef511b77755142b37502928f.html#.E6.AD.A5.E9.AA.A4.E4.B8.89.EF.BC.9A.E9.80.89.E5.8F.96.E5.8D.A1.E5.88.B8.E8.83.8C.E6.99.AF.E9.A2.9C.E8.89.B2" class="external text" rel="nofollow">选取卡券背景颜色接口文档</a>，选择适用色值，让优惠券变得更加个性，在步骤四创建卡券中将颜色名（如Color010）填入color字段。 </p> 
      <h3> <span class="mw-headline" id=".E5.88.9B.E5.BB.BA.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.8E.A5.E5.8F.A3"><b>创建朋友的券接口</b></span></h3> 
      <p><b>创建朋友的券接口是创建系列接口最重要的一环</b>。 </p>
      <p><b>朋友的券是在原有卡券的基础上衍生出的一种高级券的类型，比起普通卡券，朋友的券可以展示有图文介绍的优惠详情（通过advanced_info字段定义），突出服务和商品摘要信息。</b> </p>
      <p><b>接口说明</b> </p>
      <p>开发者需调用该接口创建朋友的券，填入商家信息、LOGO、门店以及相关的优惠和使用字段。创建成功后，会获得Card_id，用于下一步的投放。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/create?access_token=ACCESS_TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> JSON数据 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>代金券POST示例</b> </p> 
      <pre> {
   "card": {
       "card_type": "CASH",
       "cash": {
           "base_info": {
               "logo_url": "<a href="http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmx" class="external free" rel="nofollow">http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmx</a> ibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0",
               "brand_name": "微信餐厅",
               "code_type": "CODE_TYPE_TEXT",
               "color": "Color010",
               "service_phone": "020-88888888",
               "description": "不可与其他优惠同享\n如需团购券发票，请在消费时向商户 提出",
               "date_info": {
                   "type": "DATE_TYPE_FIX_TIME_RANGE",
                   "begin_timestamp": 1447397802,
                   "end_timestamp": 1449893532
               },
               "can_share": false,
               "can_give_friend": false,
               "location_id_list": [
                   272981040,
                   400183234
               ],
               "get_limit": 3,
               "center_title": "快速核销",
               "center_sub_title": "",
               "center_url": "www.xxx.com",
               "custom_url_name": "立即使用",
               "custom_url": "<a href="http://www.qq.com" class="external free" rel="nofollow">http://www.qq.com</a>",
               "custom_url_sub_title": "6个汉字tips",
               "promotion_url_name": "更多优惠",
               "promotion_url": "<a href="http://www.qq.com" class="external free" rel="nofollow">http://www.qq.com</a>"
           },
           "advanced_info": {
               "use_condition": {
                   "accept_category": "鞋类",
                   "reject_category": "阿迪达斯",
                   "can_use_with_other_discount": true
               },
               "abstract": {
                   "abstract": "微信餐厅推出多种新季菜品，期待您的光临",
                   "icon_url_list": [
                       "<a href="http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sj" class="external free" rel="nofollow">http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sj</a>  piby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0"
                   ]
               },
               "text_image_list": [
                   {
                       "image_url": "<a href="http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0" class="external free" rel="nofollow">http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0</a>",
                       "text": "此菜品精选食材，以独特的烹饪方法，最大程度地刺激食 客的味蕾"
                   },
                   {
                       "image_url": "<a href="http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sj" class="external free" rel="nofollow">http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sj</a> piby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0",
                       "text": "此菜品迎合大众口味，老少皆宜，营养均衡"
                   }
               ],
               "time_limit": [
                   {
                       "type": "MONDAY",
                       "begin_hour":0,
                       "end_hour":10,
                       "begin_minute":10,
                       "end_minute":59
                   },
                   {
                       "type": "HOLIDAY"
                   }
               ],
               "business_service": [
                   "BIZ_SERVICE_FREE_WIFI",
                   "BIZ_SERVICE_WITH_PET",
                   "BIZ_SERVICE_FREE_PARK",
                   "BIZ_SERVICE_DELIVER"
               ],
               "consume_share_self_num": 1,
               "consume_share_card_list": [],
               "share_friends": true
           },
           "reduce_cost": 10
       }
   }
}
</pre> 
      <p><b>兑换券POST示例</b> </p> 
      <pre>{
   "card": {
       "card_type": "GIFT",
       "gift": {
           "base_info": {
              ``````````````
              ```````````````
           },
           "advanced_info": {
              
               ``````````````
              ```````````````
             
           },
           "gift_name":"苹果",
           "gift_num":1,
           "gift_unit":"个"
           "gift": "送苹果一个"
       }
   }
}
</pre> 
      <p><b>朋友的券JSON结构解析</b> </p>
      <p><a href="#" class="image"><img alt="朋友的券JSON字段解析.png" src="../static/assets/9e83fbdcefe6c86f7494254dc6176274.png" width="826" height="696"></a> </p>
      <p>在以上字段中除卡券基本信息之外，代金券与兑换券均相同，故兑换券JSON不作展示。 </p>
      <p><b>卡券信息字段</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:150px">字段 </th> 
         <th style="width:500px">说明 </th> 
         <th>是否必填 </th>
        </tr> 
        <tr> 
         <td> card_type </td> 
         <td> 卡券类型，现仅支持代金券类型和兑换券类型，填写CASH或者GIFT </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> cash </td> 
         <td> 代金券类型json结构函数名 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> reduce_cost </td> 
         <td> 代金券专用，表示减免金额（单位为分），不可填0。 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> gift </td> 
         <td> 兑换券券类型json结构函数名 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> gift_name </td> 
         <td> 兑换券兑换商品名字，限6个汉字 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> gift_num </td> 
         <td> 兑换券兑换商品数目，限三位数字 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> gift_unit </td> 
         <td> 兑换券兑换商品的数量单位，限两个汉字 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> gift </td> 
         <td> 兑换券类型时显示的礼品详情 </td> 
         <td> 是 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>Base_info（卡券基础信息）字段</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:150px">字段 </th> 
         <th style="width:5000px">说明 </th> 
         <th>是否必填 </th>
        </tr> 
        <tr> 
         <td> base_info </td> 
         <td> 基本卡券数据，对于任何卡券类型base_info字段相同 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> logo_url </td> 
         <td> 卡券商家LOGO，请使用调用<a href="../15/e33671f4ef511b77755142b37502928f.html#.E4.B8.8A.E4.BC.A0.E5.9B.BE.E7.89.87.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">上传图片接口</a>获得的url </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> code_type </td> 
         <td> 卡券的code类型<br>"CODE_TYPE_TEXT"，文本；<br>"CODE_TYPE_BARCODE"，一维码； <p>"CODE_TYPE_QRCODE"，二维码；<br>"CODE_TYPE_ONLY_QRCODE",二维码无code显示； <br>"CODE_TYPE_ONLY_BARCODE",一维码无code显示；<br>"CODE_TYPE_NONE"无code类型 </p> </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> brand_name </td> 
         <td> 商家名字,上限为12个汉字 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> color </td> 
         <td> 券颜色，请参考 <p><a href="../15/e33671f4ef511b77755142b37502928f.html#.E6.AD.A5.E9.AA.A4.E4.B8.89.EF.BC.9A.E9.80.89.E5.8F.96.E5.8D.A1.E5.88.B8.E8.83.8C.E6.99.AF.E9.A2.9C.E8.89.B2" class="external text" rel="nofollow">选取卡券背景颜色接口文档</a> </p> </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> notice </td> 
         <td> 使用提醒，上限为12个汉字（一句话描述，展示在首页，示例：请出示二维码核销卡券） </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> description </td> 
         <td> 使用说明。长文本描述，可以分行，上限为1000个汉字 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> date_info </td> 
         <td> 使用日期，有效期的信息，仅支持DATE_TYPE_FIX_TIME_RANGE </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> begin_timestamp </td> 
         <td> DATE_TYPE_FIX_TIME_RANGE时专用，表示起用时间。从1970年1月1日00:00:00至起用时间的秒数，最终需转换为字符串形态传入，下同。（单位为秒） </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> end_timestamp </td> 
         <td> DATE_TYPE_FIX_TIME_RANGE表示结束时间。从1970年1月1日00:00:00至起用时间的秒数，最终需转换为字符串形态传入。（单位为秒） </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> location_id_list </td> 
         <td> 门店位置ID，请参考<a href="../11/081986f089826bf94393bef9bf287b8b.html#.E5.BE.AE.E4.BF.A1.E9.97.A8.E5.BA.97.E6.8E.A5.E5.8F.A3.E6.96.87.E6.A1.A3" class="external text" rel="nofollow">微信门店接口文档</a>，朋友的券须至少传入一个可用poi_id,否则报错 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> can_share </td> 
         <td> 是否支持分享到对话、朋友圈，与share_friends字段互斥，若创建朋友共享券此处应填入false,不可为空 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> can_give_friend </td> 
         <td> 是否支持赠送，与share_friends字段互斥，若创建朋友共享券此处应填入false,不可为空 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> service_phone </td> 
         <td> 客服电话 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> get_limit </td> 
         <td> 领取限制，限制用户扫码或点击H5领取的次数 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> center_title </td> 
         <td> 居中置顶的url标题，一般为快速核销或者快速买单，用于跳转商户自己开发的核销或者买单页面，9个中文字符以内。该cell仅限卡券状态正常，且处于有效期内的时候显示。 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> center_sub_title </td> 
         <td> 居中置顶的url副标题，显示在标题下方，12个中文字符以内。该标题仅限卡券状态正常，且处于有效期内的时候显示。 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> center_url </td> 
         <td> 居中置顶的url，该url仅限卡券状态正常，且处于有效期内的时候显示。 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> custom_url_name </td> 
         <td> 商家自定义入口名称，与custom_url字段共同使用，长度限制在5个汉字内 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> custom_url </td> 
         <td> 商家自定义入口跳转外链的地址链接,跳转页面内容需与自定义cell名称保持匹配 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> custom_url_sub_title </td> 
         <td> 显示在入口右侧的tips，长度限制在6个汉字内 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> promotion_url_name </td> 
         <td> 营销场景的自定义入口 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> promotion_url </td> 
         <td> 入口跳转外链的地址链接。 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> promotion_url_sub_title </td> 
         <td> 显示在入口右侧的tips，长度限制在6个汉字内 </td> 
         <td> 否 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>Advanced_info（卡券高级信息）字段</b> </p>
      <p><br> 新增门槛字段，代金券类型（CASH）的卡券可以与满减门槛（least_cost字段）、指定品类可用/不可用门槛（accept_category/reject_category）不与其他优惠共享门槛组合使用。 </p>
      <p>兑换券类型（GIFT）的卡券可以与满减门槛（least_cost字段）、买送门槛（object_use_for字段）和不与其他优惠共享门槛组合使用。 </p>
      <p><br> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:150px">字段 </th> 
         <th style="width:500px">说明 </th> 
         <th>是否必填 </th>
        </tr> 
        <tr> 
         <td> advanced_info </td> 
         <td> 创建优惠券特有的高级字段 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> use_condition </td> 
         <td> 使用门槛（条件）字段 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> accept_category </td> 
         <td> 指定可用的商品类目，仅用于代金券类型，填入后将在券面拼写适用于xxx，标题自动拼为xxx减50元（若仅填入5个字），50元代金券（填入5个字以上）。 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> reject_category </td> 
         <td> 指定不可用的商品类目，仅用于代金券类型，填入后将在券面拼写不适用于xxx。 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> least_cost </td> 
         <td> 满减门槛字段，可用于兑换券和代金券，填入后将在全面拼写消费满xx元可用，标题自动拼为满xx减xx/满xx送xx(gift_name) </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> object_use_for </td> 
         <td> 购买xx可用类型门槛，仅用于兑换，填入后自动拼写购买xxx可用，标题自动拼为买xx送xx(gift_name) </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> can_use_with_other_discount </td> 
         <td> 不可以与其他类型共享门槛，填写false时系统将在使用须知里拼写不可与其他优惠共享，默认为true </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> abstract </td> 
         <td> 封面摘要结构体名称 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> abstract </td> 
         <td> 封面摘要简介。 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> icon_url_list </td> 
         <td> 封面图片列表，仅支持填入一个封面图片链接，<a href="../15/e33671f4ef511b77755142b37502928f.html#.E4.B8.8A.E4.BC.A0.E5.9B.BE.E7.89.87.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">上传图片接口</a>上传获取图片获得链接，填写非CDN链接会报错，并在此填入。建议图片尺寸像素850*350 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> text_image_list </td> 
         <td> 图文列表，显示在详情内页，优惠券券开发者须至少传入一组图文列表 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> image_url </td> 
         <td> 图片链接，必须调用<a href="../15/e33671f4ef511b77755142b37502928f.html#.E4.B8.8A.E4.BC.A0.E5.9B.BE.E7.89.87.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">上传图片接口</a>上传图片获得链接，并在此填入，否则报错 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> text </td> 
         <td> 图文描述，5000字以内 </td> 
         <td> 是 </td>
        </tr> 
        <tr> 
         <td> business_service </td> 
         <td> 商家服务类型： <p>BIZ_SERVICE_DELIVER 外卖服务；BIZ_SERVICE_FREE_PARK 停车位；BIZ_SERVICE_WITH_PET 可带宠物；BIZ_SERVICE_FREE_WIFI 免费wifi，可多选 </p> </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> time_limit </td> 
         <td> 使用时段限制 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> type </td> 
         <td> 限制类型枚举值：支持填入 <p>MONDAY 周一 TUESDAY 周二 WEDNESDAY 周三 THURSDAY 周四 FRIDAY 周五 SATURDAY 周六 SUNDAY 周日 HOLIDAY 假期通用 此处只控制显示，不控制实际使用逻辑，不填默认不显示 </p> </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> begin_hour </td> 
         <td> 当前type类型下的起始时间（小时），如当前结构体内填写了MONDAY，此处填写了10，则此处表示周一 10:00可用 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> begin_minute </td> 
         <td> 当前type类型下的起始时间（分钟），如当前结构体内填写了MONDAY，begin_hour填写10，此处填写了59，则此处表示周一 10:59可用 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> end_hour </td> 
         <td> 当前type类型下的结束时间（小时），如当前结构体内填写了MONDAY，此处填写了20，则此处表示周一 10:00-20:00可用 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> end_minute </td> 
         <td> 当前type类型下的结束时间（分钟），如当前结构体内填写了MONDAY，begin_hour填写10，此处填写了59，则此处表示周一 10:59-00:59可用 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> consume_share_self_num </td> 
         <td> 核销后送券的数量，可设置核销后送<b>本卡券</b>的数量，限制传入1张，与consume_share_card_list字段互斥 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> consume_share_card_list </td> 
         <td> 核销后赠送<b>其他卡券</b>的列表，与consume_share_self_num字段互斥 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 核销后赠送的其他卡券card_id，目前仅支持填入一个共享券card_id，此处必须填入共享券 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> num </td> 
         <td> 核销后赠送的该card_id数目，目前仅支持填1 </td> 
         <td> 否 </td>
        </tr> 
        <tr> 
         <td> share_friends </td> 
         <td> 是否支持分享给朋友使用，填写true优惠券才可被共享 </td> 
         <td> 是 </td>
        </tr> 
       </tbody>
      </table> 
      <p>注意事项： </p>
      <p>1.<b>门槛字段用于拼接标题以及券面的优惠说明，请开发者务必按照要求选择填写</b>，以免造成不必要的麻烦。 2.填入时间限制字段（time_limit）,只控制显示，不控制实际使用逻辑，不填默认不显示。 3.若填写了时间限制字段（time_limit）中的type，未填写具体的起止小时（hour）和分钟（munite）,则默认为全天可用。 </p>
      <p><br> <b>返回数据</b> </p> 
      <pre>{
 "errcode": 0,
 "errmsg": "ok",
 "card_id": "pbLatjtQrAGz1Iaz08qB_H3NSBrc"
}
</pre> 
      <p><b>字段说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">字段名 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> 错误码 </td> 
         <td> 错误码，0为正常，40071为格式错误，请对比JSON示例排查错误 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息 </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 卡券id </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E5.AE.A1.E6.A0.B8.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><b>审核事件推送</b></span></h3> 
      <p>生成的卡券通过审核时，微信会把这个事件推送到开发者填写的URL。 点击查看<a href="../16/28b34ee91675a04cb24853768debded4.html#.E5.8D.A1.E5.88.B8.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81" class="external text" rel="nofollow">卡券事件推送机制</a> </p> 
      <pre>&lt;xml&gt; 
  &lt;ToUserName&gt;&lt;![CDATA[toUser]]&gt;&lt;/ToUserName&gt;  
  &lt;FromUserName&gt;&lt;![CDATA[FromUser]]&gt;&lt;/FromUserName&gt;  
  &lt;CreateTime&gt;123456789&lt;/CreateTime&gt;  
  &lt;MsgType&gt;&lt;![CDATA[event]]&gt;&lt;/MsgType&gt;  
  &lt;Event&gt;&lt;![CDATA[card_pass_check]]&gt;&lt;/Event&gt;  
  &lt;CardId&gt;&lt;![CDATA[cardid]]&gt;&lt;/CardId&gt; 
&lt;/xml&gt;
</pre> 
      <p>参数说明： </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数 </th> 
         <th style="width:350px">说明 </th>
        </tr> 
        <tr> 
         <td> ToUserName </td> 
         <td> 开发者微信号 </td>
        </tr> 
        <tr> 
         <td> FromUserName </td> 
         <td> 发送方帐号（一个OpenID） </td>
        </tr> 
        <tr> 
         <td> CreateTime </td> 
         <td> 消息创建时间 （整型） </td>
        </tr> 
        <tr> 
         <td> MsgType </td> 
         <td> 消息类型，event </td>
        </tr> 
        <tr> 
         <td> Event </td> 
         <td> 事件类型，card_pass_check(卡券通过审核)、card_not_pass_check（卡券未通过审核） </td>
        </tr> 
        <tr> 
         <td> CardId </td> 
         <td> 卡券ID </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.94.AF.E6.8C.81.E4.B9.B0.E5.8D.95"><b>朋友的券支持买单</b></span></h3> 
      <p>同普通卡券一样，朋友的券一样支持微信快速买单，开通了微信支付的商户可以点击<a href="../15/e33671f4ef511b77755142b37502928f.html#.E8.AE.BE.E7.BD.AE.E5.BF.AB.E9.80.9F.E4.B9.B0.E5.8D.95" class="external text" rel="nofollow">设置买单接口</a>为朋友的券开通买单，便捷收银。 </p> 
      <h2> <span class="mw-headline" id=".E5.B8.AE.E5.8A.A9"><b>帮助</b></span></h2> 
      <h3> <span class="mw-headline" id=".E9.94.99.E8.AF.AF.E7.A0.81"><b>错误码</b></span></h3> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">错误码 </th> 
         <th style="width:300px">说明 </th> 
         <th style="width:300px">排错指引 </th>
        </tr> 
        <tr> 
         <td> 40079 </td> 
         <td> 有效期错误 </td> 
         <td> 须将有效期设置为90天以内 </td>
        </tr> 
        <tr> 
         <td> 40141 </td> 
         <td> 图片url错误 </td> 
         <td> 须使用将图片上传至CDN后获得的url </td>
        </tr> 
        <tr> 
         <td> 40143 </td> 
         <td> 错误的起用金额 </td> 
         <td> 须将代金券的起用金额字段（least_cost）设置为0 </td>
        </tr> 
        <tr> 
         <td> 41025 </td> 
         <td> 缺少location_list </td> 
         <td> 创建的JSON中须填入location_list(即poi_id，门店id) </td>
        </tr> 
        <tr> 
         <td> 42001 </td> 
         <td> token过期 </td> 
         <td> 重新获取最新的token调用接口，若有多个调用源，需要统一管理token </td>
        </tr> 
        <tr> 
         <td> 47001 </td> 
         <td> 创建JSON结构错误 </td> 
         <td> 针对报错信息提示的位置对比示例排查 </td>
        </tr> 
       </tbody>
      </table> 
      <p>更多错误码，请见<a href="../7/981e7a73e2bca37a3d1c83f071be6947.html" class="external text" rel="nofollow">卡券全局错误码</a> </p> 
      <h3> <span class="mw-headline" id=".E5.B8.B8.E8.A7.81.E9.97.AE.E9.A2.98"><b>常见问题</b></span></h3> 
      <p><b>1.为什么朋友的券不能在创建的时候填入库存？</b> </p>
      <p>朋友的券库存机制与普通券不同，开发者须先创建卡券后，到MP（商户后台）用券点充值库存，不支持在创建的时候填入库存。 </p>
      <p><b>2.为什么朋友的券只能创建三个月时长的卡券？</b> </p>
      <p>朋友的券不同于普通卡券，有很强的时效性和活动性，为了保证用户的券列表能常来常新，我们约定，每个商户最多只能创建时长不超过三个月（90天)的卡券。 </p>
      <p><b>3.卡券过期了券点会退吗？</b> </p>
      <p>若卡券过期时，card_id内尚有库存，我们会将库存折合券点退回商户的账户，周期为T+1（隔日退回）。 </p> 
      <h1> <span class="mw-headline" id=".E9.85.8D.E7.BD.AE.E5.BA.93.E5.AD.98.E3.80.81.E5.85.85.E5.80.BC.E5.88.B8.E7.82.B9">配置库存、充值券点</span></h1> 
      <p>该部分介绍开发者怎样为card_id配置库存以及充值、管理账号的券点。 </p> 
      <h2> <span class="mw-headline" id=".E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E"><b>接口说明</b></span></h2> 
      <p>创建朋友的券成功后，开发者可以通过接口为card_id配置库存，不同于普通券的是，朋友的券库存须使用券点（<a href="https://mp.weixin.qq.com/cgi-bin/readtemplate?t=cardticket/faq_tmpl&amp;type=info&amp;token=1707566880&amp;lang=zh_CN" class="external text" rel="nofollow">什么是券点？</a>）兑换，券点分为免费券点和付费券点，免费券点由微信平台赠送产生，而付费券点由开发者充值产生。 </p> 
      <h2> <span class="mw-headline" id=".E6.8E.A5.E5.8F.A3.E8.B0.83.E7.94.A8.E6.B5.81.E7.A8.8B_2"><b>接口调用流程</b></span></h2> 
      <p><a href="#" class="image"><img alt="充值券点流程.png" src="../static/assets/69adf2f09eb9f8e39452f72cb4fd011b.png" width="727" height="264"></a> </p> 
      <h2> <span class="mw-headline" id="API.E5.88.97.E8.A1.A8_2"><b>API列表</b></span></h2> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:50px">步骤 </th> 
         <th>API名称 </th> 
         <th>用途 </th> 
         <th>API属性 </th>
        </tr> 
        <tr> 
         <td>1 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E5.BC.80.E9.80.9A.E5.88.B8.E7.82.B9.E8.B4.A6.E6.88.B7.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">开通券点账户接口</a> </td> 
         <td>开通券点账户 </td> 
         <td>库存接口 </td>
        </tr> 
        <tr> 
         <td>2 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E5.AF.B9.E4.BC.98.E6.83.A0.E5.88.B8.E6.89.B9.E4.BB.B7" class="external text" rel="nofollow">对优惠券批价接口</a> </td> 
         <td>获取对当前card_id充值一定量的库存所耗费的券点总额 </td> 
         <td>库存接口 </td>
        </tr> 
        <tr> 
         <td>3 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.9F.A5.E8.AF.A2.E5.88.B8.E7.82.B9.E4.BD.99.E9.A2.9D.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">查询券点余额接口</a> </td> 
         <td>查询账户内券点是否可以支付本次批价的库存充值 </td> 
         <td>库存接口 </td>
        </tr> 
        <tr> 
         <td>4 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E7.A1.AE.E8.AE.A4.E5.85.91.E6.8D.A2.E5.BA.93.E5.AD.98.E6.8E.A5.E5.8F.A33" class="external text" rel="nofollow">确认兑换库存接口</a> </td> 
         <td>确认充值库存 </td> 
         <td>库存接口 </td>
        </tr> 
        <tr> 
         <td>5 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E5.85.85.E5.80.BC.E5.88.B8.E7.82.B9.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">充值券点接口</a> </td> 
         <td>使用微信支付充值账户内的券点 </td> 
         <td>充值接口 </td>
        </tr> 
        <tr> 
         <td>6 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.9F.A5.E8.AF.A2.E8.AE.A2.E5.8D.95.E8.AF.A6.E6.83.85.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">查询订单详情接口</a> </td> 
         <td>查询某次充值订单的状态 </td> 
         <td>充值接口 </td>
        </tr> 
        <tr> 
         <td>6 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.9F.A5.E8.AF.A2.E6.B5.81.E6.B0.B4.E8.AF.A6.E6.83.85.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">查询流水详情接口</a> </td> 
         <td>查询库存、券点订单的状态 </td> 
         <td>管理接口 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id="API.E8.AF.A6.E6.83.85_2"><b>API详情</b></span></h2> 
      <p>该部分主要介绍库存、券点接口的调用方法和传递参数。 </p> 
      <h3> <span class="mw-headline" id=".E5.BC.80.E9.80.9A.E5.88.B8.E7.82.B9.E8.B4.A6.E6.88.B7.E6.8E.A5.E5.8F.A3"><b>开通券点账户接口</b></span></h3> 
      <p>本接口用于开发者为当前appid开通券点账户并获得免费券点奖励 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>HTTP请求方式: GET
<a href="https://api.weixin.qq.com/card/pay/activate?access_token=ACCESS_TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/pay/activate?access_token=ACCESS_TOKEN</a>
</pre> 
      <p><br> <b>返回数据示例</b> </p> 
      <pre>{
 "errcode": 0,
 "errmsg": "ok",
 "reward": 200
}
</pre> 
      <p><b>返回数据示例</b> </p> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
        <tr> 
         <td> reward </td> 
         <td> 奖励券点数量，以元为单位，微信卡券对每一个新开通券点账户的商户奖励200个券点，点击查看券点规则<a href="https://mp.weixin.qq.com/cgi-bin/readtemplate?t=cardticket/faq_tmpl&amp;type=info&amp;token=136421560&amp;lang=zh_CN#2dot6" class="external text" rel="nofollow">什么是券点？</a> </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E5.AF.B9.E4.BC.98.E6.83.A0.E5.88.B8.E6.89.B9.E4.BB.B7"><b>对优惠券批价</b></span></h3> 
      <p>本接口用于提前查询本次新增库存需要多少券点 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>HTTP请求方式: POST
<a href="https://api.weixin.qq.com/card/pay/getpayprice?access_token=ACCESS_TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/pay/getpayprice?access_token=ACCESS_TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
 "card_id":"pbLatjpQxxxxxxxxCEV_cLTwoB7yU",
 "quantity":"1"
}
</pre> 
      <p><br> <b>请求参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 是 </td> 
         <td> string(32) </td> 
         <td> pFS7Fjg8kV1IdDz01r4SQwMkuCKc </td> 
         <td> 需要来配置库存的card_id </td>
        </tr> 
        <tr> 
         <td> quantity </td> 
         <td> 是 </td> 
         <td> int </td> 
         <td> 100 </td> 
         <td> 本次需要兑换的库存数目 </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> <b>返回数据示例</b> </p> 
      <pre>{
 "errcode": 0,
 "errmsg": "ok",
 "order_id": "P9zzllX2VJ5NgiF9kFVarX7bc8r-       ms_5Dy091evc2eIuxtZvZobeomE1p9Dw8v7lFBhqKM4YgrZa54uuWhf3hw7KquEOfmx5FplGKRIf7Ag5  Ww-YdxP-KeT6LeJBttb1xpY0Uf7g8DNHrbUyHopolqfUqPBBLDEmB7Z-91I8",
 "price": "0.2",
 "free_coin": "0.2",
 "pay_coin": "0"
}
</pre> 
      <p><br> </p> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
        <tr> 
         <td> order_id </td> 
         <td> 本次批价的订单号，用于下面的确认充值库存接口，仅对当前订单有效且仅可以使用一次，60s内可用于兑换库存。 </td>
        </tr> 
        <tr> 
         <td> price </td> 
         <td> 本次需要支付的券点总额度 </td>
        </tr> 
        <tr> 
         <td> free_coin </td> 
         <td> 本次需要支付的免费券点额度 </td>
        </tr> 
        <tr> 
         <td> pay_coin </td> 
         <td> 本次需要支付的付费券点额度 </td>
        </tr> 
       </tbody>
      </table> 
      <p>注意：关于券点机制详情请见 [<a href="https://mp.weixin.qq.com/cgi-bin/readtemplate" class="external free" rel="nofollow">https://mp.weixin.qq.com/cgi-bin/readtemplate</a>? t=cardticket/faq_tmpl&amp;type=info&amp;token=136421560&amp;lang=zh_CN#2dot6 什么是券点？] </p> 
      <h3> <span class="mw-headline" id=".E6.9F.A5.E8.AF.A2.E5.88.B8.E7.82.B9.E4.BD.99.E9.A2.9D.E6.8E.A5.E5.8F.A3"><b>查询券点余额接口</b></span></h3> 
      <p>本接口用于开发者查询当前券点账户中的免费券点/付费券点数目以及总额。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>HTTP请求方式: GET
<a href="https://api.weixin.qq.com/card/pay/getcoinsinfo?access_token=ACCESS_TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/pay/getcoinsinfo?access_token=ACCESS_TOKEN</a>
</pre> 
      <p><br> <b>返回数据示例</b> </p> 
      <pre>{
 "errcode": 0,
 "errmsg": "ok",
 "free_coin": 200
 "pay_coin": 1
 "total_coin": 201
}
</pre> 
      <p><b>返回参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息 </td>
        </tr> 
        <tr> 
         <td> free_coin </td> 
         <td> 免费券点数目 </td>
        </tr> 
        <tr> 
         <td> pay_coin </td> 
         <td> 免费券点数目 </td>
        </tr> 
        <tr> 
         <td> total_coin </td> 
         <td> 全部券点数目 </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> </p> 
      <h3> <span class="mw-headline" id=".E7.A1.AE.E8.AE.A4.E5.85.91.E6.8D.A2.E5.BA.93.E5.AD.98.E6.8E.A5.E5.8F.A3"><b>确认兑换库存接口</b></span></h3> 
      <p>本接口用于确认兑换库存，确认后券点兑换为库存，过程不可逆。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>HTTP请求方式: POST
<a href="https://api.weixin.qq.com/card/pay/confirm?access_token=ACCESS_TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/pay/confirm?access_token=ACCESS_TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
"card_id":"pbLatjpxxxxlCEV_cLTwoB7yU",
"order_id":  "P9zzllX2VJ5NgiF9kFVarX7bc8r-ms_5Dy091evc2eIuxtZvZobeomE1p9Dw8v7lFBhqKM4YgrZa54uuWhf3hw7KquEOfmx5FplGKRIfkbR7Ag5WwYdxP-KeT6LeJBttb1xpYxxxxxxxxxxxxHrbUyHopolqfUqPBBLDEmB7Z-91I8",
"quantity":"1"
}
</pre> 
      <p><b>请求参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 是 </td> 
         <td> string(32) </td> 
         <td> pFS7Fjg8kV1IdDz01r4SQwMkuCKc </td> 
         <td> 需要来兑换库存的card_id </td>
        </tr> 
        <tr> 
         <td> quantity </td> 
         <td> 是 </td> 
         <td> int </td> 
         <td> 100 </td> 
         <td> 本次需要兑换的库存数目 </td>
        </tr> 
        <tr> 
         <td> order_id </td> 
         <td> 是 </td> 
         <td> string </td> 
         <td> P9zzllX2VJ5NgiF9kFVarX7bc8r </td> 
         <td> 仅可以使用上面得到的订单号，保证批价有效性 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据示例</b> </p> 
      <pre>{
   "errcode":0,
   "errmsg":"ok"
}
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>特别注意</b>： </p>
      <p>上一步获得的order_id须在60s内使用，否则确认兑换库存接口将会失效 </p> 
      <h3> <span class="mw-headline" id=".E5.85.85.E5.80.BC.E5.88.B8.E7.82.B9.E6.8E.A5.E5.8F.A3"><b>充值券点接口</b></span></h3> 
      <p>开发者可以通过此接口为券点账户充值券点，1元等于1点。开发者调用接口后可以获得一个微信支付的支付二维码链接， 开发者可以将链接转化为二维码扫码支付。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>HTTP请求方式: POST
<a href="https://api.weixin.qq.com/card/pay/recharge?access_token=ACCESS_TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/pay/recharge?access_token=ACCESS_TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
"coin_count":100
}
</pre> 
      <p><br> <b>请求参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> coin_count </td> 
         <td> 是 </td> 
         <td> int </td> 
         <td> 10000 </td> 
         <td> 需要充值的券点数目，1点=1元 </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> <b>返回数据示例</b> </p> 
      <pre>{
 "errcode": 0,
 "errmsg": "ok",
 "order_id": "100005790120***221401000171",
 "qrcode_url": "weixin://wxpay/bizpayurl?pr=xxxxxxxxx",
 "qrcode_buffer": "pwxs*************xxxxxxxxxx",
}
</pre> 
      <p><br> </p> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
        <tr> 
         <td> order_id </td> 
         <td> 本次支付的订单号，用于查询订单状态 </td>
        </tr> 
        <tr> 
         <td> qrcode_url </td> 
         <td> 支付二维码的的链接，开发者可以调用二维码生成的公开库转化为二维码显示在网页上，微信扫码支付 </td>
        </tr> 
        <tr> 
         <td> qrcode_buffer </td> 
         <td> 二维码的数据流，开发者可以使用写入一个文件的方法显示该二维码 </td>
        </tr> 
       </tbody>
      </table> 
      <p>注意： </p>
      <p>开发者可以参考以下方法将buffer显示二维码 </p> 
      <pre>&lt;?php
$file = fopen("test.jpg","w");
echo fwrite($file, $qrcode_buffer);
fclose($file);
?&gt;
</pre> 
      <h3> <span class="mw-headline" id=".E6.9F.A5.E8.AF.A2.E8.AE.A2.E5.8D.95.E8.AF.A6.E6.83.85.E6.8E.A5.E5.8F.A3"><b>查询订单详情接口</b></span></h3> 
      <p>本接口用于查询充值订单的状态 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>HTTP请求方式: POST
<a href="https://api.weixin.qq.com/card/pay/getorder?access_token=ACCESS_TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/pay/getorder?access_token=ACCESS_TOKEN</a> 
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
"order_id": "100005790********401000171"
}
</pre> 
      <p><br> </p>
      <p><b>请求参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> order_id </td> 
         <td> 是 </td> 
         <td> int </td> 
         <td> 10000 </td> 
         <td> 上一步中获得的订单号，作为一次交易的唯一凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> <b>返回数据示例</b> </p> 
      <pre>{
 "errcode": 0,
 "errmsg": "ok",
 "order_info": {
   "order_id": "100005790120151221401000171",
   "status": "ORDER_STATUS_FINANCE_SUCC",
   "create_time": 1450712798,
   "pay_finish_time": 1450712905,
   "desc": "微信支付充值",
   "free_coin_count": "0",
   "pay_coin_count": "1",
   "refund_free_coin_count": "0",
   "refund_pay_coin_count": "0",
   "openid": "oWE-GwF1gGoyVVZC5PG6GXd4cKMY",
   "order_type": "ORDER_TYPE_WXPAY"
 }
}
</pre> 
      <p><b>返回数据说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息 </td>
        </tr> 
        <tr> 
         <td> order_info </td> 
         <td> 订单信息结构体 </td>
        </tr> 
        <tr> 
         <td> order_id </td> 
         <td> 订单号 </td>
        </tr> 
        <tr> 
         <td> status </td> 
         <td> 订单状态， <p>ORDER_STATUS_WAITING 等待支付 ORDER_STATUS_SUCC 支付成功 ORDER_STATUS_FINANCE_SUCC 加代币成功 ORDER_STATUS_QUANTITY_SUCC 加库存成功 ORDER_STATUS_HAS_REFUND 已退币 ORDER_STATUS_REFUND_WAITING 等待退币确认 ORDER_STATUS_ROLLBACK 已回退,系统失败 ORDER_STATUS_HAS_RECEIPT 已开发票 </p> </td>
        </tr> 
        <tr> 
         <td> create_time </td> 
         <td> 订单创建时间 </td>
        </tr> 
        <tr> 
         <td> pay_finish_time </td> 
         <td> 支付完成时间 </td>
        </tr> 
        <tr> 
         <td> desc </td> 
         <td> 支付描述，一般为微信支付充值 </td>
        </tr> 
        <tr> 
         <td> free_coin_count </td> 
         <td> 本次充值的免费券点数量，以元为单位 </td>
        </tr> 
        <tr> 
         <td> pay_coin_count </td> 
         <td> 本次充值的付费券点数量，以元为单位 </td>
        </tr> 
        <tr> 
         <td> refund_free_coin_count </td> 
         <td> 回退的免费券点 </td>
        </tr> 
        <tr> 
         <td> refund_pay_coin_count </td> 
         <td> 回退的付费券点 </td>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 支付人的openid </td>
        </tr> 
        <tr> 
         <td> order_tpye </td> 
         <td> 订单类型，ORDER_TYPE_WXPAY为充值 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E6.9F.A5.E8.AF.A2.E5.88.B8.E7.82.B9.E6.B5.81.E6.B0.B4.E8.AF.A6.E6.83.85.E6.8E.A5.E5.8F.A3"><b>查询券点流水详情接口</b></span></h3> 
      <p>本接口用于查询券点的流水详情。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>HTTP请求方式: POST
<a href="https://api.weixin.qq.com/card/pay/getorderlist?access_token=ACCESS_TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/pay/getorderlist?access_token=ACCESS_TOKEN</a> 
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
           "offset": 0,
           "count": 5,
           "order_type": "ORDER_TYPE_WXPAY",
           "nor_filter": {
               "status": "ORDER_STATUS_SUCC"
           },
           "sort_info": {
               "sort_key": "SORT_BY_TIME",
               "sort_type": "SORT_DESC"
           },
           "begin_time": "1440420538",
           "end_time": "1450713203"
}
</pre> 
      <p><br> <b>请求参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> offset </td> 
         <td> 否 </td> 
         <td> int </td> 
         <td> 0 </td> 
         <td> 分批查询的起点，默认为0 </td>
        </tr> 
        <tr> 
         <td> count </td> 
         <td> 否 </td> 
         <td> int </td> 
         <td> 50 </td> 
         <td> 分批查询的数量 </td>
        </tr> 
        <tr> 
         <td> begin_time </td> 
         <td> 否 </td> 
         <td> int </td> 
         <td> 14552146398 </td> 
         <td> 批量查询订单的起始事件，为时间戳，默认1周前 </td>
        </tr> 
        <tr> 
         <td> end_time </td> 
         <td> 否 </td> 
         <td> int </td> 
         <td> 14552146398 </td> 
         <td> 批量查询订单的结束事件，为时间戳，默认为当前时间 </td>
        </tr> 
        <tr> 
         <td> order_type </td> 
         <td> 否 </td> 
         <td> string </td> 
         <td> ORDER_TYPE_WXPAY </td> 
         <td> 所要拉取的订单类型 <p>ORDER_TYPE_SYS_ADD 平台赠送 ORDER_TYPE_WXPAY 充值 ORDER_TYPE_REFUND 库存回退券点 ORDER_TYPE_REDUCE 券点兑换库存 ORDER_TYPE_SYS_REDUCE 平台扣减 </p> </td>
        </tr> 
        <tr> 
         <td> nor_filter </td> 
         <td> 否 </td> 
         <td> JSON结构 </td> 
         <td> ORDER_STATUS_QUANTITY_SUCC </td> 
         <td> 反选，不要拉取的订单 </td>
        </tr> 
        <tr> 
         <td> status </td> 
         <td> 否 </td> 
         <td> string </td> 
         <td> ORDER_STATUS_REFUND_WAITING </td> 
         <td> 不要拉取的订单状态 <p>订单状态包括： ORDER_STATUS_WAITING 等待支付 ORDER_STATUS_SUCC 支付成功 ORDER_STATUS_FINANCE_SUCC 加代币成功 ORDER_STATUS_QUANTITY_SUCC 加库存成功 ORDER_STATUS_HAS_REFUND 已退币 ORDER_STATUS_REFUND_WAITING 等待退币确认 ORDER_STATUS_ROLLBACK 已回退,系统失败 ORDER_STATUS_HAS_RECEIPT 已开发票 </p> </td>
        </tr> 
        <tr> 
         <td> sort_info </td> 
         <td> 否 </td> 
         <td> JSON结构 </td> 
         <td> </td> 
         <td> 对结果排序 </td>
        </tr> 
        <tr> 
         <td> sort_key </td> 
         <td> 否 </td> 
         <td> string </td> 
         <td> SORT_BY_TIME </td> 
         <td> 排序依据，SORT_BY_TIME 以订单时间排序 </td>
        </tr> 
        <tr> 
         <td> sort_type </td> 
         <td> 否 </td> 
         <td> string </td> 
         <td> SORT_DESC </td> 
         <td> 排序规则，SORT_ASC 升序 <p>SORT_DESC 降序 </p> </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> <b>返回数据示例</b> </p> 
      <pre>{
 "errcode": 0,
 "errmsg": "ok",
 "total_num": 1,
 "order_list": [
   {
     "order_id": "100005790120151221401000171",
     "status": "ORDER_STATUS_FINANCE_SUCC",
     "create_time": 1450712798,
     "pay_finish_time": 1450712905,
     "desc": "微信支付充值",
     "free_coin_count": "0",
     "pay_coin_count": "1",
     "refund_free_coin_count": "0",
     "refund_pay_coin_count": "0",
     "openid": "oWE-GwF1gGoyVVZC5PG6GXd4cKMY",
     "order_type": "ORDER_TYPE_WXPAY"
   }
 ]
}
</pre> 
      <p><br> <b>返回数据说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息 </td>
        </tr> 
        <tr> 
         <td> total_num </td> 
         <td> 符合条件的订单总数量 </td>
        </tr> 
        <tr> 
         <td> order_list </td> 
         <td> 显示的订单详情列表，根据offset和count来显示 </td>
        </tr> 
        <tr> 
         <td> order_id </td> 
         <td> 订单号 </td>
        </tr> 
        <tr> 
         <td> status </td> 
         <td> 订单状态， <p>ORDER_STATUS_WAITING 等待支付 ORDER_STATUS_SUCC 支付成功 ORDER_STATUS_FINANCE_SUCC 加代币成功 ORDER_STATUS_QUANTITY_SUCC 加库存成功 ORDER_STATUS_HAS_REFUND 已退币 ORDER_STATUS_REFUND_WAITING 等待退币确认 ORDER_STATUS_ROLLBACK 已回退,系统失败 ORDER_STATUS_HAS_RECEIPT 已开发票 </p> </td>
        </tr> 
        <tr> 
         <td> create_time </td> 
         <td> 订单创建时间 </td>
        </tr> 
        <tr> 
         <td> pay_finish_time </td> 
         <td> 支付完成时间 </td>
        </tr> 
        <tr> 
         <td> desc </td> 
         <td> 支付描述，一般为微信支付充值 </td>
        </tr> 
        <tr> 
         <td> free_coin_count </td> 
         <td> 本次充值的付费券点数量，以元为单位 </td>
        </tr> 
        <tr> 
         <td> pay_coin_count </td> 
         <td> 二维码的数据流，开发者可以使用写入一个文件的方法显示该二维码 </td>
        </tr> 
        <tr> 
         <td> refund_free_coin_count </td> 
         <td> 回退的免费券点 </td>
        </tr> 
        <tr> 
         <td> refund_pay_coin_count </td> 
         <td> 回退的付费券点 </td>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 支付人的openid </td>
        </tr> 
        <tr> 
         <td> order_tpye </td> 
         <td> 订单类型，ORDER_TYPE_WXPAY为充值 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E5.88.B8.E7.82.B9.E6.B5.81.E6.B0.B4.E8.AF.A6.E6.83.85.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><b>券点流水详情事件推送</b></span></h3> 
      <p>当券点发生变动时，微信服务器会将本次变动的类型、券点数额以及时间等信息推送给开发者服务器。 </p>
      <p>详情请见：<a href="../16/28b34ee91675a04cb24853768debded4.html#.E5.88.B8.E7.82.B9.E6.B5.81.E6.B0.B4.E8.AF.A6.E6.83.85.E4.BA.8B.E4.BB.B6" class="external text" rel="nofollow">券点流水详情事件推送</a> </p> 
      <h1> <span class="mw-headline" id=".E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.8A.95.E6.94.BE"><b>朋友的券投放</b></span></h1> 
      <h2> <span class="mw-headline" id=".E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E_2"><b>接口说明</b></span></h2> 
      <p>该部分主要讲述微信卡券不同的投放渠道和投放方式，建议开发者仔细阅读本部分文档，避免在投放过程中出现消费者无法共享的情况。 </p> 
      <h2> <span class="mw-headline" id=".E5.BC.80.E5.8F.91.E8.80.85.E6.B3.A8.E6.84.8F.E4.BA.8B.E9.A1.B9_2"><b>开发者注意事项</b></span></h2> 
      <p>共享券投放与普通券投放<b>略有不同</b>。现共享券仅支持线下二维码扫码投放（不包含长按二维码识别）、摇一摇Beacon投放的H5以及WIFI环境H5投放场景，共享券同时支持扫码跳转H5后领券，<b>其他投放渠道暂不支持</b>。 </p> 
      <h2> <span class="mw-headline" id=".E6.A1.88.E4.BE.8B.E4.BB.8B.E7.BB.8D"><b>案例介绍</b></span></h2> 
      <h3> <span class="mw-headline" id=".E5.8D.A1.E5.88.B8.E4.BA.8C.E7.BB.B4.E7.A0.81.E6.8A.95.E6.94.BE"><b>卡券二维码投放</b></span></h3> 
      <h4> <span class="mw-headline" id=".E5.9C.BA.E6.99.AF.E4.BB.8B.E7.BB.8D"><b>场景介绍</b></span></h4> 
      <p>二维码一般用于商户卡券的店内投放、海报投放和传单投放，商户通过接口生成二维码之后，可以将二维码贴在收银台、海报、传单等宣传物料上。用户扫码后可以将卡券共享至共享券列表，供自己和朋友们使用。 </p> 
      <h4> <span class="mw-headline" id=".E4.BD.BF.E7.94.A8.E6.B5.81.E7.A8.8B"><b>使用流程</b></span></h4> 
      <p><a href="#" class="image"><img alt="二维码领券.png" src="../static/assets/c0dbd9f95d82d8354a8a675ab1bdd044.png" width="739" height="367"></a> </p>
      <p>完成以上流程，开发者需要： </p>
      <p>1.创建朋友的券并再通过审核之后在【微信公众平台商户后台】增加库存； </p>
      <p>2.调用创建二维码接口生成领券二维码； </p>
      <p>3.监听领取时间推送，记录卡券发放量并做数据统计； </p> 
      <h4> <span class="mw-headline" id="API.E5.88.97.E8.A1.A8_3"><b>API列表</b></span></h4> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">步骤 </th> 
         <th>API名称 </th> 
         <th>用途 </th> 
         <th>API属性 </th>
        </tr> 
        <tr> 
         <td>1 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E7.94.9F.E6.88.90.E4.BA.8C.E7.BB.B4.E7.A0.81.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">生成二维码接口</a> </td> 
         <td>创建二维码得到二维码的展示url </td> 
         <td>投放接口 </td>
        </tr> 
        <tr> 
         <td>2 </td> 
         <td><a href="../16/28b34ee91675a04cb24853768debded4.html#.E9.A2.86.E5.8F.96.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81" class="external text" rel="nofollow">卡券领取事件推送</a> </td> 
         <td>用户领取卡券后，获得用户的openid、code和card_id等信息 </td> 
         <td>事件推送 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id="H5.E7.BD.91.E9.A1.B5.E6.8A.95.E6.94.BE"><b>H5网页投放</b></span></h3> 
      <h4> <span class="mw-headline" id=".E5.9C.BA.E6.99.AF.E4.BB.8B.E7.BB.8D_2"><b>场景介绍</b></span></h4> 
      <p>开发者可以开发领券H5网页，并将url转化成二维码或者配置在微信摇一摇或者微信Wi-Fi投放。 该渠道适用于对领取页面有要求的商户，可以自定义页面样式体现品牌价值或者自定义领取流程（如加入游戏环节）等。 </p>
      <p>注意： </p>
      <p>1.目前仅支持线下场景投放，如卡券二维码、从扫码进入H5网页扫码或者从Wi-Fi或者iBeacon进入的网页领券。其他渠道暂不支持。 </p>
      <p>2.点击此处了解<a href="https://wifi.weixin.qq.com/biz/mp/join-process.xhtml" class="external text" rel="nofollow">Wi-Fi</a>和微信摇一摇<a href="https://zb.weixin.qq.com/intro.xhtml" class="external text" rel="nofollow">摇一摇周边（iBeacon）</a> </p> 
      <h4> <span class="mw-headline" id=".E6.8E.A5.E5.8F.A3.E8.B0.83.E7.94.A8.E6.B5.81.E7.A8.8B_3"><b>接口调用流程</b></span></h4> 
      <p><a href="#" class="image"><img alt="H5投放接口调用流程.png" src="../static/assets/d80ba59d17b0e8b6e2d1c5cd57ead713.png" width="489" height="399"></a> </p> 
      <h4> <span class="mw-headline" id="API.E5.88.97.E8.A1.A8_4"><b>API列表</b></span></h4> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">步骤 </th> 
         <th>API名称 </th> 
         <th>用途 </th> 
         <th>API属性 </th>
        </tr> 
        <tr> 
         <td>1 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E8.8E.B7.E5.8F.96JSAPI_TICKET.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">获取JSAPI_TICKET接口</a> </td> 
         <td>获取到JSAPI_TICKET用于参与JS SDK config </td> 
         <td>基础接口 </td>
        </tr> 
        <tr> 
         <td>2 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E8.8E.B7.E5.8F.96.E5.8D.A1.E5.88.B8API_TICKET.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">获取卡券API_TICKET接口</a> </td> 
         <td>获取到卡券API_TICKET用于cardext内signarue签名 </td> 
         <td>投放接口 </td>
        </tr> 
        <tr> 
         <td>3 </td> 
         <td><a href="../11/74ad127cc054f6b80759c40f77ec03db.html#.E6.89.B9.E9.87.8F.E6.B7.BB.E5.8A.A0.E5.8D.A1.E5.88.B8.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">批量添加卡券接口</a> </td> 
         <td>将共享券添加到用户的券列表 </td> 
         <td>投放接口 </td>
        </tr> 
        <tr> 
         <td>4 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E5.8D.A1.E5.88.B8.E9.A2.86.E5.8F.96.E4.BA.8B.E4.BB.B6" class="external text" rel="nofollow">卡券领取事件推送</a> </td> 
         <td>用户领取卡券后，获得用户的openid、code和card_id等信息 </td> 
         <td>事件推送 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id="API.E8.AF.A6.E6.83.85_3"><b>API详情</b></span></h2> 
      <h3> <span class="mw-headline" id=".E8.AE.BE.E7.BD.AE.E6.B5.8B.E8.AF.95.E7.99.BD.E5.90.8D.E5.8D.95.E6.8E.A5.E5.8F.A3"><b>设置测试白名单接口</b></span></h3> 
      <p>当朋友的券审核未通过时，开发者可以通过设置白名单的方式领取朋友的券并共享。 共享的未审核状态的券仅白名单列表内可见，详情请见：<a href="../5/f942979ef2f0d313d4d36e3a26766a3d.html#.E8.AE.BE.E7.BD.AE.E6.B5.8B.E8.AF.95.E7.99.BD.E5.90.8D.E5.8D.95" class="external text" rel="nofollow">设置测试白名单接口</a> </p> 
      <h3> <span class="mw-headline" id=".E7.94.9F.E6.88.90.E4.BA.8C.E7.BB.B4.E7.A0.81.E6.8E.A5.E5.8F.A3"><b>生成二维码接口</b></span></h3> 
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/qrcode/create?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/qrcode/create?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> JSON数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p>
      <p>开发者可以设置扫描二维码领取单张卡券，此时POST数据为： </p> 
      <pre> {
"action_name": "QR_CARD", 
"expire_seconds": 1800,
"action_info": {
"card": {
"card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc", 
"code": "198374613512",
"openid": "oFS7Fjl0WsZ9AMZqrI80nbIq8xrA",
"is_unique_code": false ,
"outer_id"&nbsp;: 1
  }
 }
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> code </td> 
         <td> 是 </td> 
         <td> string(20) </td> 
         <td> 110201201245 </td> 
         <td> 卡券Code码,use_custom_code字段为true的卡券必须填写，非自定义code不必填写。。 </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 否 </td> 
         <td> string(32) </td> 
         <td> pFS7Fjg8kV1IdDz01r4SQwMkuCKc </td> 
         <td> 卡券ID。 </td>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 否 </td> 
         <td> string(32) </td> 
         <td> oXch-jkrxp42VQu8ldweCwDt97qo </td> 
         <td> 指定领取者的openid，只有该用户能领取。bind_openid字段为true的卡券必须填写，非指定openid不必填写。 </td>
        </tr> 
        <tr> 
         <td> expire_seconds </td> 
         <td> 否 </td> 
         <td> unsigned int </td> 
         <td> 60 </td> 
         <td> 指定二维码的有效时间，范围是60 ~ 1800秒。不填默认为永久有效。 </td>
        </tr> 
        <tr> 
         <td> is_unique_code </td> 
         <td> 否 </td> 
         <td> bool </td> 
         <td> false </td> 
         <td> 指定下发二维码，生成的二维码随机分配一个code，领取后不可再次扫描。填写true或false。默认false。 </td>
        </tr> 
        <tr> 
         <td> outer_id </td> 
         <td> 否 </td> 
         <td> int </td> 
         <td> 12 </td> 
         <td> 领取场景值，用于领取渠道的数据统计，默认值为0，字段类型为整型，长度限制为60位数字。用户领取卡券后触发的<a href="../16/28b34ee91675a04cb24853768debded4.html#.E9.A2.86.E5.8F.96.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81" class="external text" rel="nofollow">事件推送</a>中会带上此自定义场景值。 </td>
        </tr> 
       </tbody>
      </table> 
      <p>注意事项： </p>
      <p>1.若开发者填写了is_unique_code为true，需要保证卡券已审核通过并有库存，否则会报错。 </p>
      <p><b>返回数据</b> </p>
      <p>数据示例： </p> 
      <pre>{
 "errcode": 0,
 "errmsg": "ok",
 "ticket":      "gQHB8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0JIV3lhX3psZmlvSDZmWGVMMTZvAAIEsNnKVQMEIAMAAA==",
 "expire_seconds": 1800,
 "url": "<a href="http://weixin.qq.com/q/BHWya_zlfioH6fXeL16o" class="external free" rel="nofollow">http://weixin.qq.com/q/BHWya_zlfioH6fXeL16o</a> ",
 "show_qrcode_url": " <a href="https://mp.weixin.qq.com/cgi-bin/showqrcode" class="external free" rel="nofollow">https://mp.weixin.qq.com/cgi-bin/showqrcode</a>?  ticket=gQH98DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0czVzRlSWpsamlyM2plWTNKVktvAAIE6SfgVQMEgDPhAQ%3D%3D"
 }
</pre> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
        <tr> 
         <td> ticket </td> 
         <td> 获取的二维码ticket，凭借此ticket调用<a href="../18/167e7d94df85d8389df6c94a7a8f78ba.html" class="external text" rel="nofollow">通过ticket换取二维码接口</a>可以在有效时间内换取二维码。 </td>
        </tr> 
        <tr> 
         <td>url </td> 
         <td>二维码图片解析后的地址，开发者可根据该地址自行生成需要的二维码图片 </td>
        </tr> 
        <tr> 
         <td>show_qrcode_url </td> 
         <td>二维码显示地址，点击后跳转二维码页面 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E8.8E.B7.E5.8F.96JSAPI_TICKET.E6.8E.A5.E5.8F.A3"><b>获取JSAPI_TICKET接口</b></span></h3> 
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: GET
<a href="https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&amp;type=jsapi" class="external free" rel="nofollow">https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&amp;type=jsapi</a>
</pre> 
      <p><b>返回数据</b> </p> 
      <pre>{
 "errcode":0,
 "errmsg":"ok",
 "ticket":"bxLdikRXVbTPdHSM05e5u5sUoXNKd8-41ZO3MhKoyN5OfkWITDGgnr2fwJ0m9E8NYzWKVZvdVtaUgWvsdshFKA",
 "expires_in":7200
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
        <tr> 
         <td> ticket </td> 
         <td> 获取的JSAPI_TICKET </td>
        </tr> 
        <tr> 
         <td> expires_in </td> 
         <td>有效时间，ticket有效时间为2小时，2小时内不变 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E8.8E.B7.E5.8F.96.E5.8D.A1.E5.88.B8API_TICKET.E6.8E.A5.E5.8F.A3"><b>获取卡券API_TICKET接口</b></span></h3> 
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: GET
<a href="https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&amp;type=wx_card" class="external free" rel="nofollow">https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&amp;type=wx_card</a>
</pre> 
      <p><b>返回数据</b> </p> 
      <pre>{
 "errcode":0,
 "errmsg":"ok",
 "ticket":"bxLdikRXVbTPdHSM05e5u5sUoXNKdvsdshFKA",
 "expires_in":7200
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
        <tr> 
         <td> ticket </td> 
         <td> 获取的卡券API_TICKET </td>
        </tr> 
        <tr> 
         <td> expires_in </td> 
         <td>有效时间，ticket有效时间为2小时，2小时内不变 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E6.89.B9.E9.87.8F.E6.B7.BB.E5.8A.A0.E5.8D.A1.E5.88.B8.EF.BC.88addcard.EF.BC.89.E6.8E.A5.E5.8F.A3"><b>批量添加卡券（addcard）接口</b></span></h3> 
      <p>朋友的券领取须指引用户升级到最新的微信客户端版本，最低版本要求为：iOS微信版本为6.3.6及以上，Android微信版本为6.3.7及以上。 开发者可以判断用户版本后调用addcard接口，请点击查看<a href="../11/74ad127cc054f6b80759c40f77ec03db.html#.E5.88.A4.E6.96.AD.E5.BD.93.E5.89.8D.E5.AE.A2.E6.88.B7.E7.AB.AF.E7.89.88.E6.9C.AC.E6.98.AF.E5.90.A6.E6.94.AF.E6.8C.81.E6.8C.87.E5.AE.9AJS.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">判断用户客户端版本</a>、<a href="../11/74ad127cc054f6b80759c40f77ec03db.html#.E6.89.B9.E9.87.8F.E6.B7.BB.E5.8A.A0.E5.8D.A1.E5.88.B8.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">批量添加卡券接口</a>。 </p> 
      <h3> <span class="mw-headline" id=".E5.8D.A1.E5.88.B8.E9.A2.86.E5.8F.96.E4.BA.8B.E4.BB.B6"><b>卡券领取事件</b></span></h3> 
      <p>用户领取朋友的券后，会有事件推送到开发者服务器。 点击查看<a href="../16/28b34ee91675a04cb24853768debded4.html#.E5.8D.A1.E5.88.B8.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81" class="external text" rel="nofollow">卡券事件推送机制</a> </p> 
      <pre>&lt;xml&gt; 
 &lt;ToUserName&gt;&lt;![CDATA[toUser]]&gt;&lt;/ToUserName&gt;  
 &lt;FromUserName&gt;&lt;![CDATA[FromUser]]&gt;&lt;/FromUserName&gt;  
 &lt;FriendUserName&gt;&lt;![CDATA[FriendUser]]&gt;&lt;/FriendUserName&gt;  
 &lt;CreateTime&gt;14476554321&lt;/CreateTime&gt;  
 &lt;MsgType&gt;&lt;![CDATA[event]]&gt;&lt;/MsgType&gt;  
 &lt;Event&gt;&lt;![CDATA[user_get_card]]&gt;&lt;/Event&gt;  
 &lt;Card_id&gt;&lt;![CDATA[card_id]]&gt;&lt;/Card_id&gt;  
 &lt;IsGiveByFriend&gt;1&lt;/IsGiveByFriend&gt;  
 &lt;UserCardCode&gt;&lt;![CDATA[12312312]]&gt;&lt;/UserCardCode&gt;  
 &lt;OuterId&gt;0&lt;/OuterId&gt; 
&lt;/xml&gt;
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数 </th> 
         <th style="width:350px">说明 </th>
        </tr> 
        <tr> 
         <td> ToUserName </td> 
         <td> 开发者微信号。 </td>
        </tr> 
        <tr> 
         <td> FromUserName </td> 
         <td> 领券方帐号（一个OpenID）。 </td>
        </tr> 
        <tr> 
         <td> FriendUserName </td> 
         <td> 赠送方账号（一个OpenID），"IsGiveByFriend”为1时填写该参数。 </td>
        </tr> 
        <tr> 
         <td> CreateTime </td> 
         <td> 消息创建时间 （整型）。 </td>
        </tr> 
        <tr> 
         <td> MsgType </td> 
         <td> 消息类型，event </td>
        </tr> 
        <tr> 
         <td> Event </td> 
         <td> 事件类型，user_get_card(用户领取卡券)。 </td>
        </tr> 
        <tr> 
         <td> CardId </td> 
         <td> 卡券ID。 </td>
        </tr> 
        <tr> 
         <td> IsGiveByFriend </td> 
         <td> 是否为转赠，1代表是，0代表否。 </td>
        </tr> 
        <tr> 
         <td> UserCardCode </td> 
         <td> code序列号。自定义code及非自定义code的卡券被领取后都支持事件推送。 </td>
        </tr> 
        <tr> 
         <td> OldUserCardCode </td> 
         <td> 转赠前的code序列号。 </td>
        </tr> 
        <tr> 
         <td> OuterId </td> 
         <td> 领取场景值，用于领取渠道数据统计。可在生成二维码接口及添加JS API接口中自定义该字段的整型值。 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id=".E5.B8.AE.E5.8A.A9_2"><b>帮助</b></span></h2> 
      <h3> <span class="mw-headline" id=".E9.94.99.E8.AF.AF.E7.A0.81_2"><b>错误码</b></span></h3> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">错误码 </th> 
         <th style="width:300px">说明 </th> 
         <th style="width:300px">排错指引 </th>
        </tr> 
        <tr> 
         <td> 40053 </td> 
         <td> JSON结构错误 </td> 
         <td> card_id或者参数名有误，请对比示例排查 </td>
        </tr> 
        <tr> 
         <td> 43008 </td> 
         <td> 当前账号未开通支付权限或未开通支付后送券接口权限，无法设置支付后送朋友的券功能 </td> 
         <td> 前往开通<a href="http://kf.qq.com/faq/120911VrYVrA150906iQjQjI.html" class="external text" rel="nofollow">微信支付</a> </td>
        </tr> 
        <tr> 
         <td> 45021 </td> 
         <td> 赠券规则列表长度高于10个 </td> 
         <td> 减少赠券规则列表的个数 </td>
        </tr> 
        <tr> 
         <td> 47001 </td> 
         <td> 创建JSON结构错误 </td> 
         <td> 针对报错信息提示的位置对比示例排查 </td>
        </tr> 
       </tbody>
      </table> 
      <p>更多错误码，请见<a href="../7/981e7a73e2bca37a3d1c83f071be6947.html" class="external text" rel="nofollow">卡券全局错误码</a> </p> 
      <h3> <span class="mw-headline" id=".E5.B8.B8.E8.A7.81.E9.97.AE.E9.A2.98_2"><b>常见问题</b></span></h3> 
      <p><b>1.如何区分领取渠道？</b> </p>
      <p>开发者可以在生成二维码或者H5添加卡券时，填入outer_id(自定义渠道值),这个数值会随领取事件推送至开发者服务器，从而使得开发者可以区分每一个code（卡券串码）的投放渠道。 </p>
      <p><b>2.为什么长按二维码不能领取卡券？</b> </p>
      <p>目前朋友的券仅支持线下渠道投放，对于线上的场景（如长按二维码领取、公众号群发）等做了限制。 </p> 
      <h1> <span class="mw-headline" id=".E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.A0.B8.E9.94.80"><b>朋友的券核销</b></span></h1> 
      <h2> <span class="mw-headline" id=".E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E_3"><b>接口说明</b></span></h2> 
      <p>此处介绍朋友的券的核销方式，分为线上和线下核销两部分，下面分不同的场景介绍。 </p> 
      <h2> <span class="mw-headline" id=".E6.A1.88.E4.BE.8B.E4.BB.8B.E7.BB.8D_2"><b>案例介绍</b></span></h2> 
      <h3> <span class="mw-headline" id=".E7.BA.BF.E4.B8.8B.E6.A0.B8.E9.94.80"><b>线下核销</b></span></h3> 
      <h4> <span class="mw-headline" id=".E6.9C.BA.E5.85.B7.E6.89.AB.E7.A0.81.E6.A0.B8.E9.94.80"><b>机具扫码核销</b></span></h4> 
      <p><b>场景介绍</b> </p>
      <p>具有机具和开发能力的商户可以通过机具扫码进行卡券核销，开发者可以通过机具扫码获得卡券code之后，调用核销code接口将卡券进行核销，方便快捷。 </p>
      <p><b>接口调用流程</b> </p>
      <p><a href="#" class="image"><img alt="机具核销接口调用流程图.png" src="../static/assets/7a3dcc54e010817943ca1e9a188667b0.png" width="422" height="378"></a> </p>
      <p><br> <b>API列表</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:50px">步骤 </th> 
         <th>API名称 </th> 
         <th>用途 </th> 
         <th>API属性 </th>
        </tr> 
        <tr> 
         <td>1 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.9F.A5.E8.AF.A2Code.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">查询code接口</a> </td> 
         <td>查询code状态，获知当前卡券是否可以核销 </td> 
         <td>管理卡券 </td>
        </tr> 
        <tr> 
         <td>2 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E7.BA.BF.E4.B8.8B.E6.A0.B8.E9.94.80Code.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">线下核销code接口</a> </td> 
         <td>设置卡券门店并通过审核获得poiid，用于创建时填入location_list字段 </td> 
         <td>核销卡券 </td>
        </tr> 
        <tr> 
         <td>3 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.A0.B8.E9.94.80.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81" class="external text" rel="nofollow">卡券核销事件</a> </td> 
         <td>获得当前卡券的使用人、code和card_id等信息 </td> 
         <td>事件推送 </td>
        </tr> 
       </tbody>
      </table> 
      <h4> <span class="mw-headline" id=".E7.BD.91.E9.A1.B5.E5.B7.A5.E5.85.B7.E6.A0.B8.E9.94.80"><b>网页工具核销</b></span></h4> 
      <p><b>场景介绍</b> </p>
      <p>若开发者没有能力进行机具开发，可以开发一个核销员端使用的网页进行朋友的券的核销，当用户出示二维码时，用户打开手机上的核销网页，点击扫描用户的二维码进行核销。 </p>
      <p><b>接口调用流程</b> </p>
      <p><a href="#" class="image"><img alt="机具核销接口调用流程图.png" src="../static/assets/7a3dcc54e010817943ca1e9a188667b0.png" width="422" height="378"></a> </p>
      <p><br> <b>API列表</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:50px">步骤 </th> 
         <th>API名称 </th> 
         <th>用途 </th> 
         <th>API属性 </th>
        </tr> 
        <tr> 
         <td>1 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.9F.A5.E8.AF.A2Code.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">查询code接口</a> </td> 
         <td>查询code状态，获知当前卡券是否可以核销 </td> 
         <td>管理卡券 </td>
        </tr> 
        <tr> 
         <td>2 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E7.BA.BF.E4.B8.8B.E6.A0.B8.E9.94.80Code.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">线下核销code接口</a> </td> 
         <td>设置卡券门店并通过审核获得poiid，用于创建时填入location_list字段 </td> 
         <td>核销卡券 </td>
        </tr> 
        <tr> 
         <td>3 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.A0.B8.E9.94.80.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81" class="external text" rel="nofollow">卡券核销事件</a> </td> 
         <td>获得当前卡券的使用人、code和card_id等信息 </td> 
         <td>事件推送 </td>
        </tr> 
       </tbody>
      </table> 
      <h4> <span class="mw-headline" id=".E5.8D.A1.E5.88.B8.E5.95.86.E6.88.B7.E5.8A.A9.E6.89.8B.E6.A0.B8.E9.94.80"><b>卡券商户助手核销</b></span></h4> 
      <p><b>场景介绍</b> </p>
      <p>手机核销助手是基于“卡券商户助手“公众号的官方卡券核销工具，同样支持朋友的券的核销。 </p>
      <p><b>快速体验</b> </p>
      <p>步骤一：关注“微信卡券商户助手” </p>
      <p><a href="#" class="image"><img alt="体验二维码.png" src="../static/assets/abd4e40486e39a97d24b43a4cadb4852.png" width="129" height="129"></a> </p>
      <p>步骤二：进入【微信公众号后台】-【卡券功能】-【卡券核销】-【添加核销员】，为自己的微信号设置核销员权限，并选择已有的门店。 </p>
      <p>步骤三：用另一台手机领取自己创建的朋友的券，展开二维码并用已设置为核销员的手机扫码或者输码核销卡券。 </p> 
      <h4> <span class="mw-headline" id=".E5.85.AC.E4.BC.97.E5.8F.B7.E5.95.86.E6.88.B7.E5.90.8E.E5.8F.B0.E6.A0.B8.E9.94.80"><b>公众号商户后台核销</b></span></h4> 
      <p>商户可以在电脑登录公众号商户后要，【卡券功能】-【卡券核销】-【网页核销】直接核销核销卡券。 </p> 
      <h3> <span class="mw-headline" id=".E7.BA.BF.E4.B8.8A.E6.A0.B8.E9.94.80"><b>线上核销</b></span></h3> 
      <p>线上核销涉及的接口与线下核销接口略有不同，线上核销接口需要消费者跳转至H5网页，所以可能会出现两个用户同时使用同一张卡券的情况，我们约定，对于没有点击卡券上的“出示使用”的核销，开发者先调用占用（mark）接口，将一个code(卡券串码)与一个openid（用户身份识别码）关联，保证该code不被另外的人使用。 </p> 
      <h4> <span class="mw-headline" id=".E7.BD.91.E9.A1.B5.E5.BF.AB.E9.80.9F.E6.A0.B8.E9.94.80"><b>网页快速核销</b></span></h4> 
      <p><b>场景介绍</b> </p>
      <p>若开发者没有办法配置核销员或者商户没办法，可以自定义一个H5核销界面，用户在券面发起核销并在开发者自定义的H5网页内完成核销和裂变送券的过程。 </p>
      <p>值得开发者注意的是，对于自助核销的卡券，开发者在创建/更新卡券是可以将code_type字段设置为CODE_TYPE_NONE,这样可以隐藏掉卡券上使用二维码的入口（如下图），同时将核销的url通过创建接口中的center_title center_sub_title，center_url写入，那么此自定义入口会指定居中（如下图） </p>
      <p>详情请见<a href="../static/assets/a52f2b856ae5f93d89b93325b6f39b83.jpg#.E5.88.9B.E5.BB.BA.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">创建朋友的券接口</a> </p>
      <p><a href="#" class="image"><img alt="网页快速核销.png" src="../static/assets/e427e8f0a6a8cc303e6a79aca723ce52.png" width="654" height="367"></a> </p>
      <p><b>接口调用流程</b> </p>
      <p><a href="#" class="image"><img alt="快速核销接口调用流程.png" src="../static/assets/ecc59f8ff94bbb6e03e25d3c5402105d.png" width="489" height="385"></a> </p>
      <p><br> <b>API列表</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:50px">步骤 </th> 
         <th>API名称 </th> 
         <th>用途 </th> 
         <th>API属性 </th>
        </tr> 
        <tr> 
         <td>1 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E8.8E.B7.E5.8F.96.E8.87.AA.E5.AE.9A.E4.B9.89.E5.A4.96.E9.93.BE.E5.8F.82.E6.95.B0" class="external text" rel="nofollow">获取自定义跳转链接参数</a> </td> 
         <td>获取加密code（encrypt_code）、card_id和openid </td> 
         <td>创建卡券 </td>
        </tr> 
        <tr> 
         <td>2 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#Code.E8.A7.A3.E7.A0.81.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">code解码接口</a> </td> 
         <td>通过加密code获得真实的code </td> 
         <td>核销卡券 </td>
        </tr> 
        <tr> 
         <td>3 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.9F.A5.E8.AF.A2Code.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">查询code接口</a> </td> 
         <td>查看code状态是否可以核销 </td> 
         <td>管理卡券 </td>
        </tr> 
        <tr> 
         <td>4 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#Mark.28.E5.8D.A0.E7.94.A8.29Code.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">Mark(占用)code接</a> </td> 
         <td>在核销之前将code锁住，防止出现两个人同时核销券的情况 </td> 
         <td>核销卡券 </td>
        </tr> 
        <tr> 
         <td>5 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E7.BA.BF.E4.B8.8A.E6.A0.B8.E9.94.80Code.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">线上核销code接口</a> </td> 
         <td>将卡券核销掉，须传入openid和code </td> 
         <td>核销接口 </td>
        </tr> 
        <tr> 
         <td>6 </td> 
         <td><a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.A0.B8.E9.94.80.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81" class="external text" rel="nofollow">卡券核销事件</a> </td> 
         <td>获得当前卡券的使用人、code和card_id等信息 </td> 
         <td>事件推送 </td>
        </tr> 
        <tr> 
         <td>7 </td> 
         <td><a href="../11/74ad127cc054f6b80759c40f77ec03db.html#.E6.A0.B8.E9.94.80.E5.90.8E.E5.86.8D.E6.AC.A1.E8.B5.A0.E9.80.81.E5.8D.A1.E5.88.B8.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">核销裂赠券接口（JSSDK）</a> </td> 
         <td>拉起裂变领取页供用户领取 </td> 
         <td>核销接口 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id="API.E8.AF.A6.E6.83.85_4"><b>API详情</b></span></h2> 
      <h3> <span class="mw-headline" id=".E6.9F.A5.E8.AF.A2Code.E6.8E.A5.E5.8F.A3"><b>查询Code接口</b></span></h3> 
      <p>我们强烈建议开发者在调用核销code接口之前调用查询code接口，并在核销之前对非法状态的code(如转赠中、已删除、已核销等)做出处理。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/code/get?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/code/get?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
   "card_id"&nbsp;: "pbLatjorLTVl-tdvZ6zQRIc-Fn6Y",
   "code"&nbsp;: "245645675434",
   "check_consume"&nbsp;: true
}
</pre> 
      <p><br> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> code </td> 
         <td> 是 </td> 
         <td> string(20) </td> 
         <td> 110201201245 </td> 
         <td> 单张卡券的唯一标准。 </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 否 </td> 
         <td> string(32) </td> 
         <td> pFS7Fjg8kV1IdDz01r4SQwMkuCKc </td> 
         <td> 卡券ID代表一类卡券。 </td>
        </tr> 
        <tr> 
         <td> check_consume </td> 
         <td> 否 </td> 
         <td> bool </td> 
         <td> true </td> 
         <td> 是否校验code核销状态，填入true和false时的code异常状态返回数据不同。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> <b>当check_consume为true时返回数据</b> </p>
      <p>卡券状态正常： </p> 
      <pre>{
 "errcode": 0,
 "errmsg": "ok",
 "card": {
   "card_id": "pbLatjhCp8_HXAq84nHritGPqnjk",
   "begin_time": 1447397802,
   "end_time": 1452893532
 },
 "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",
 "can_consume": true,
 "user_card_status": "NORMAL",
 "mark_openid": "obLatjjwDolFjRRd3doGIdwNqRXw",
 "use_count": 1
}
</pre> 
      <p>卡券状态异常： </p> 
      <pre>{
 "errcode": 40127,
 "errmsg": "invalid user-card status! Hint: the card was given to user, but may be    deleted or set unavailable&nbsp;! hint: [iHBD40040ent3]"
}
</pre> 
      <p><b>当check_consume为false时返回数据</b> </p>
      <p>卡券状态正常： </p> 
      <pre>{
 "errcode": 0,
 "errmsg": "ok",
 "card": {
   "card_id": "pbLatjhCp8_HXAq84nHritGPqnjk",
   "begin_time": 1447397802,
   "end_time": 1452893532
 },
 "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",
 "can_consume": true,
 "user_card_status": "NORMAL",
 "mark_openid": "obLatjjwDolFjRRd3doGIdwNqRXw",
 "use_count": 1
}
</pre> 
      <p>卡券状态异常： </p> 
      <pre>{
 "errcode": 0,
 "errmsg": "ok",
 "card": {
   "card_id": "pbLatjhCp8_HXAq84nHritGPqnjk",
   "begin_time": 1447397802,
   "end_time": 1452893532
 },
 "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",
 "can_consume": false,
 "user_card_status": "DELETE",
 "mark_openid": "obLatjjwDolFjRRd3doGIdwNqRXw",
 "use_count": 1
}
</pre> 
      <p><br> </p> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 领取该卡券用户的openid </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 卡券ID </td>
        </tr> 
        <tr> 
         <td> begin_time </td> 
         <td> 起始使用时间 </td>
        </tr> 
        <tr> 
         <td> end_time </td> 
         <td> 结束时间 </td>
        </tr> 
        <tr> 
         <td> user_card_status </td> 
         <td> 当前code对应卡券的状态， NORMAL 正常 CONSUMED 已核销 EXPIRE 已过期 GIFTING 转赠中 <p>GIFT_TIMEOUT 转赠超时 DELETE 已删除，UNAVAILABLE 已失效； code未被添加或被转赠领取的情况则统一报错：invalid serial code </p> </td>
        </tr> 
        <tr> 
         <td> can_consume </td> 
         <td> 是否可以核销，true为可以核销，false为不可核销 </td>
        </tr> 
        <tr> 
         <td> mark_openid </td> 
         <td> 当前占用此卡券的顾客的openid，核销时仅限该openid的用户可以核销该卡券 </td>
        </tr> 
        <tr> 
         <td> use_count </td> 
         <td> 当前占用这个卡券的人已经使用该card_id的次数 </td>
        </tr> 
       </tbody>
      </table> 
      <p>注： </p>
      <p>1.固定时长有效期会根据用户实际领取时间转换，如用户2013年10月1日领取，固定时长有效期为90天，即有效时间为2013年10月1日-12月29日有效。 </p>
      <p>2.无论check_consume填写的是true还是false,当code未被添加或者code被转赠领取是统一报错：invalid serial code </p> 
      <h3> <span class="mw-headline" id=".E6.8B.89.E5.8F.96.E5.8D.A1.E5.88.B8.E5.88.97.E8.A1.A8.28ChooseCard.29.E6.8E.A5.E5.8F.A3"><b>拉取卡券列表(ChooseCard)接口</b></span></h3> 
      <p>微信 JS SDK 只能在微信内置浏览器中使用,其他浏览器调用无效。微信提供chooseCard接口供商户前端网页调用,用于拉起用户名下该商家筛选条件的卡券内容。 </p>
      <p>点击查看 <a href="../11/74ad127cc054f6b80759c40f77ec03db.html#.E6.8B.89.E5.8F.96.E9.80.82.E7.94.A8.E5.8D.A1.E5.88.B8.E5.88.97.E8.A1.A8.E5.B9.B6.E8.8E.B7.E5.8F.96.E7.94.A8.E6.88.B7.E9.80.89.E6.8B.A9.E4.BF.A1.E6.81.AF" class="external text" rel="nofollow">调起适用于门店的卡券列表并获取用户选择列表JS SDK</a> </p>
      <p><a href="#" class="image"><img alt="JS choosecard.png" src="../static/assets/bf37477039ab9e0c87dfe0f73ccbc249.png" width="659" height="369"></a> </p> 
      <h3> <span class="mw-headline" id=".E8.8E.B7.E5.8F.96.E8.87.AA.E5.AE.9A.E4.B9.89.E5.A4.96.E9.93.BE.E5.8F.82.E6.95.B0"><b>获取自定义外链参数</b></span></h3> 
      <p>为了满足商户基于卡券本身的扩展诉求，允许卡券内页添加url跳转外链。带有的的字段有openid、encrypt_code、card_id。 </p>
      <p>假如指定的url为http://www.qq.com，用户点击时，跳转的url则为： <a href="http://www.qq.com?card_id=pWXUrtw4ehIUwDTXxkvCC6THenb8" class="external free" rel="nofollow">http://www.qq.com?card_id=pWXUrtw4ehIUwDTXxkvCC6THenb8</a> &amp;encrypt_code= LPmXP%2BZFM9bdEQPSqcA8%2F%2F6pefbsKaRxnNUMHh5%2Fq6Q%3D &amp;openid=oWXUrt8i3***ymgmPcHKlo0TdgHw </p>
      <p>注意： </p>
      <p>1.encrypt_code为加密码码，需调用解码接口获取真实Code码。 </p>
      <p>2.从url中取出的参数须经过urlencode方可用于post请求。 </p> 
      <h3> <span class="mw-headline" id="Code.E8.A7.A3.E7.A0.81.E6.8E.A5.E5.8F.A3"><b>Code解码接口</b> </span></h3> 
      <p>code解码接口支持两种场景： 1.商家获取choosecard_info后，将card_id和encrypt_code字段通过解码接口，获取真实code。 2.卡券内跳转外链的签名中会对code进行加密处理，通过调用解码接口获取真实code。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/code/decrypt?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/code/decrypt?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> JSON数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
  "encrypt_code":"XXIzTtMqCxwOaawoE91+VJdsFmv7b8g0VZIZkqf4GWA60Fzpc8ksZ/5ZZ0DVkXdE"
}

</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> encrypt_code </td> 
         <td> 是 </td> 
         <td> string(128) </td> 
         <td> XXIzTtMqCxwOaawoE91+VJdsFmv7b8g0VZIZkqf4GWA60Fzpc8ksZ/5ZZ0DVkXdE </td> 
         <td> 经过加密的Code码。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p>
      <p>数据示例： </p> 
      <pre> {
  "errcode":0,
  "errmsg":"ok",
  "code":"751234212312"
  }
</pre> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
        <tr> 
         <td> code </td> 
         <td> 解密后获取的真实Code码 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id="Mark.28.E5.8D.A0.E7.94.A8.29Code.E6.8E.A5.E5.8F.A3"><b>Mark(占用)Code接口</b></span></h3> 
      <p>朋友的券由于共享的特性，会出现多个消费者同时进入某一个卡券的自定义H5网页的情况，若该网页涉及线上下单、核销、支付等行为，会造成两个消费者同时使用同一张券，会有一个消费者使用失败的情况，为此我们设计了mark（占用）code接口。 </p>
      <p>对于出示核销（消费者点击“出示使用”按钮）的场景，开发者直接调用核销接口，无需考虑mark逻辑，此时由客户端代为完成。 </p>
      <p>对于消费者进入H5网页核销的情况，我们约定，开发者在帮助消费者核销卡券之前，必须帮助先将此code（卡券串码）与一个openid绑定（即mark住），才能进一步调用核销接口，否则报错。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/code/mark?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/code/mark?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> JSON数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
 "code": "114567897765",
 "card_id": "pbxxxxxxxxhjahkdjad",
 "openid": "obcdkalgsdklkdooooooo",
 "is_mark": true
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> code </td> 
         <td> 是 </td> 
         <td> 卡券的code码。 </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 是 </td> 
         <td> 卡券的ID。 </td>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 是 </td> 
         <td> 用券用户的openid。 </td>
        </tr> 
        <tr> 
         <td> is_mark </td> 
         <td> 是 </td> 
         <td> 是否要mark（占用）这个code，填写true或者false，表示占用或解除占用。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p>
      <p>数据示例： </p> 
      <pre> {
  "errcode":0,
  "errmsg":"ok",
  }
</pre> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息 </td>
        </tr> 
       </tbody>
      </table> 
      <p>注意： </p>
      <p>1. 接口只支持未使用、正常状态的朋友的券，开发者调用前须查询code。 </p>
      <p>2. is_mark不填默认为true。 </p>
      <p>3. 重复用同一个openid mark，都返回成功。 </p>
      <p>4. 用openid_a mark后，用openid_b mark会报错40146 </p>
      <p>5. is_mark为false时取消mark，要求传入的openid和mark时一致，否则报错40416。 </p>
      <p>6. 不调用接口解除mark的话，5分钟后自动解除。（时间可能根据产品策略调整） </p> 
      <h3> <span class="mw-headline" id=".E7.BA.BF.E4.B8.8B.E6.A0.B8.E9.94.80Code.E6.8E.A5.E5.8F.A3"><b>线下核销Code接口</b></span></h3> 
      <p>消耗code接口是核销卡券的唯一接口，仅支持核销有效期内的卡券，否则会返回错误码invalid time。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/code/consume?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/code/consume?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>非自定义Code卡券的请求
{
  "code": "12312313"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> code </td> 
         <td> 是 </td> 
         <td> string(20) </td> 
         <td> 1231231 </td> 
         <td> 需核销的Code码。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p>
      <p>数据示例： </p> 
      <pre> {
"errcode":0,
"errmsg":"ok",
"card":{"card_id":"pFS7Fjg8kV1IdDz01r4SQwMkuCKc"},
"openid":"oFS7Fjl0WsZ9AMZqrI80nbIq8xrA"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码。 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息。 </td>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 用户在该公众号内的唯一身份标识。 </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 卡券ID。 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E7.BA.BF.E4.B8.8A.E6.A0.B8.E9.94.80Code.E6.8E.A5.E5.8F.A3"><b>线上核销Code接口</b></span></h3> 
      <p>线上核销code接口与普通的核销code接口不同，开发者须传入当前使用该卡券顾客的openid才可以核销。 </p>
      <p><br> <b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/code/consume?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/code/consume?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>{
  "code": "12312313",
  "openid":"oFS7Fjl0WsZ9AMZqrI80nbIq8xrA"
}

</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> code </td> 
         <td> 是 </td> 
         <td> string(20) </td> 
         <td> 1231231 </td> 
         <td> 需核销的Code码。 </td>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 是 </td> 
         <td> string(20) </td> 
         <td> oFS7Fjl0WsZ9AMZqrI80nbIq8xrA </td> 
         <td> 当前卡券使用者的openid，通常通过网页授权登录或自定义url跳转参数获得。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据</b> </p>
      <p>数据示例： </p> 
      <pre> {
"errcode":0,
"errmsg":"ok",
"card":{"card_id":"pFS7Fjg8kV1IdDz01r4SQwMkuCKc"},
"openid":"oFS7Fjl0WsZ9AMZqrI80nbIq8xrA"
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="7" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码。 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td>错误信息。 </td>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 用户在该公众号内的唯一身份标识。 </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 卡券ID。 </td>
        </tr> 
       </tbody>
      </table> 
      <p>注意： </p>
      <p>1.只有在线上核销的场景时，调用核销接口才需要传openid参数； 2.线下核销的场景下，核销接口传递的参数仅为code，无需openid； </p> 
      <h3> <span class="mw-headline" id=".E6.A0.B8.E9.94.80.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><b>核销事件推送</b></span></h3> 
      <p>卡券被核销时，微信会把这个事件推送到开发者填写的URL。 点击查看<a href="../16/28b34ee91675a04cb24853768debded4.html#.E5.8D.A1.E5.88.B8.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81" class="external text" rel="nofollow">卡券事件推送机制</a> </p>
      <p>推送XML数据包示例： </p> 
      <pre> &lt;xml&gt; &lt;ToUserName&gt;&lt;![CDATA[toUser]]&gt;&lt;/ToUserName&gt; 
  &lt;FromUserName&gt;&lt;![CDATA[FromUser]]&gt;&lt;/FromUserName&gt; 
  &lt;CreateTime&gt;123456789&lt;/CreateTime&gt; 
  &lt;MsgType&gt;&lt;![CDATA[event]]&gt;&lt;/MsgType&gt; 
  &lt;Event&gt;&lt;![CDATA[user_consume_card]]&gt;&lt;/Event&gt; 
  &lt;CardId&gt;&lt;![CDATA[cardid]]&gt;&lt;/CardId&gt; 
  &lt;UserCardCode&gt;&lt;![CDATA[12312312]]&gt;&lt;/UserCardCode&gt;
  &lt;ConsumeSource&gt;&lt;![CDATA[(FROM_API)]]&gt;&lt;/ConsumeSource&gt;
  &lt;OutTradeNo&gt;&lt;![CDATA[aaaaaaaaaaaa]]&gt;&lt;/OutTradeNo&gt;
  &lt;TransId&gt;&lt;![CDATA[bbbbbbbbbb]]&gt;&lt;/TransId&gt;
  &lt;LocationName&gt;&lt;![CDATA[Tit分店]]&gt;&lt;/LocationName&gt;
  &lt;StaffOpenId&gt;&lt;![CDATA[obLatjjwDolFjRRd3doGIdwNqRXw]&gt;&lt;/StaffOpenId&gt;
 &lt;/xml&gt;
</pre> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数 </th> 
         <th style="width:350px">说明 </th>
        </tr> 
        <tr> 
         <td> ToUserName </td> 
         <td> 开发者微信号。 </td>
        </tr> 
        <tr> 
         <td> FromUserName </td> 
         <td> 发送方帐号（一个OpenID）。 </td>
        </tr> 
        <tr> 
         <td> CreateTime </td> 
         <td> 消息创建时间 （整型）。 </td>
        </tr> 
        <tr> 
         <td> MsgType </td> 
         <td> 消息类型，event。 </td>
        </tr> 
        <tr> 
         <td> Event </td> 
         <td> 事件类型，user_consume_card(核销事件) </td>
        </tr> 
        <tr> 
         <td> CardId </td> 
         <td> 卡券ID。 </td>
        </tr> 
        <tr> 
         <td> UserCardCode </td> 
         <td> 卡券Code码。 </td>
        </tr> 
        <tr> 
         <td> ConsumeSource </td> 
         <td> 核销来源。支持开发者统计API核销（FROM_API）、公众平台核销（FROM_MP）、卡券商户助手核销（FROM_MOBILE_HELPER）（核销员微信号） </td>
        </tr> 
        <tr> 
         <td> LocationName </td> 
         <td> 门店名称，当前卡券核销的门店名称（只有通过卡券商户助手和买单核销时才会出现） </td>
        </tr> 
        <tr> 
         <td> StaffOpenId </td> 
         <td> 核销该卡券核销员的openid（只有通过卡券商户助手核销时才会出现） </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E6.A0.B8.E9.94.80.E5.90.8E.E5.86.8D.E6.AC.A1.E8.B5.A0.E9.80.81.E5.8D.A1.E5.88.B8.E6.8E.A5.E5.8F.A3.EF.BC.88JS_SDK.EF.BC.89"><b>核销后再次赠送卡券接口（JS SDK）</b></span></h3> 
      <p>当用户使用优惠券后，商家可通过JS SDK再次赠送一张卡券。 </p>
      <p><a href="#" class="image"><img alt="网页快速核销.png" src="../static/assets/e427e8f0a6a8cc303e6a79aca723ce52.png" width="654" height="367"></a> </p>
      <p>该接口仅限6.3.6以上版本客户端使用，且须配置1.1.0的js文件<a href="https://res.wx.qq.com/open/js/jweixin-1.1.0.js" class="external free" rel="nofollow">https://res.wx.qq.com/open/js/jweixin-1.1.0.js</a> </p>
      <p>详情请见<a href="../11/74ad127cc054f6b80759c40f77ec03db.html#.E6.A0.B8.E9.94.80.E5.90.8E.E5.86.8D.E6.AC.A1.E8.B5.A0.E9.80.81.E5.8D.A1.E5.88.B8.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">核销后再次赠送卡券接口</a> </p> 
      <h2> <span class="mw-headline" id=".E5.B8.AE.E5.8A.A9_3"><b>帮助</b></span></h2> 
      <h3> <span class="mw-headline" id=".E9.94.99.E8.AF.AF.E7.A0.81_3"><b>错误码</b></span></h3> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">错误码 </th> 
         <th style="width:300px">说明 </th> 
         <th style="width:300px">排错指引 </th>
        </tr> 
        <tr> 
         <td> 40003 </td> 
         <td> Invalid opened，缺少openid </td> 
         <td> 核销时用户的卡券未处于展示（mark）状态，朋友的券规定，券必须处于展示（mark）状态时，才允许被核销 </td>
        </tr> 
        <tr> 
         <td> 40056 </td> 
         <td> 无效code </td> 
         <td> Code尚未被领取 </td>
        </tr> 
        <tr> 
         <td> 40075 </td> 
         <td> 错误的encrypt码 </td> 
         <td> 请检查加密码是否拼写正确，请检查在url中取出encrypt_code（加密code）在post之前是否做过urlencode </td>
        </tr> 
        <tr> 
         <td> 40078 </td> 
         <td> 该Code已经被删除或者转赠中 </td> 
         <td> 建议开发者在调用核销接口之前先调用【查询code接口】确认code有效后再发起核销 </td>
        </tr> 
        <tr> 
         <td> 40079 </td> 
         <td> 卡券过期 </td> 
         <td> 建议开发者在调用核销接口之前先调用【查询code接口】确认code有效后再发起核销 </td>
        </tr> 
        <tr> 
         <td> 40099 </td> 
         <td> Code已经被核销 </td> 
         <td> 建议开发者在调用核销接口之前先调用【查询code接口】确认code有效后再发起核销 </td>
        </tr> 
        <tr> 
         <td> 40127 </td> 
         <td> 该Code已经被删除、置为失效或者转赠成功 </td> 
         <td> 建议开发者在调用核销接口之前先调用【查询code接口】确认code有效后再发起核销 </td>
        </tr> 
       </tbody>
      </table> 
      <p>更多错误码，请见<a href="../7/981e7a73e2bca37a3d1c83f071be6947.html" class="external text" rel="nofollow">卡券全局错误码</a> </p> 
      <h3> <span class="mw-headline" id=".E5.B8.B8.E8.A7.81.E9.97.AE.E9.A2.98_3"><b>常见问题</b></span></h3> 
      <p><b>1、为什么JSSDK拉起卡券列表中没有卡券？</b> </p>
      <p>A:JSSDK拉不起卡券一般为签名错误和筛选条件错误，两种情况。 签名错误是指卡券签名错误，建议用<a href="http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=cardsign调试" class="external free" rel="nofollow">http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=cardsign调试</a> 筛选条件错误是指shopid/cardid/和cardtype传参有误，比如传入了cash类型的cardtype,但是实际上用户卡包中无此类型卡券。 </p>
      <p><b>2、为什么要调用mark住接口？</b> </p>
      <p>A：由于朋友的券会出现在不同的用户列表中，所以在同一时刻可能有多个用户同时进入开发者开发的核销页面或者下单、支付页面，会出现用户付款但是没有成功核销卡券的情况，所以我们约定必须在卡券核销之前调用mark住接口将code与当前的openid锁定。 其本质是将code与当前使用者锁定的一个锁、 比如快速买单和商城下单的场景可以在支付前调用mark接口，如果mark失败则停止支付，而开发了自主核销页面的开发者可以选择在核销之前mark住code，从而避免冲突的发生。 </p>
      <p><br> </p> 
      <h1> <span class="mw-headline" id=".E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E7.AE.A1.E7.90.86.E6.8E.A5.E5.8F.A3"><b>朋友的券管理接口</b></span></h1> 
      <h2> <span class="mw-headline" id=".E6.9B.B4.E6.96.B0.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E4.BF.A1.E6.81.AF.E6.8E.A5.E5.8F.A3"><b>更新朋友的券信息接口</b></span></h2> 
      <p><b>接口说明</b> </p>
      <p>创建朋友的券成功之后开发者可调用该接口更改卡券信息，某些需要修改后送审的字段开发者需慎重处理 </p>
      <p><br> <b>开发者注意事项</b> </p>
      <p>1. 更改卡券的部分字段后会重新提交审核，详情见字段说明，更新成功后可通过调用查看卡券详情接口核查更新结果； </p>
      <p>2. 仅填入需要更新的字段，许多开发者在调用该接口时会填入brandname（品牌名称）等不支持修改的字段，导致更新不成功。 </p>
      <p>3. 调用该接口后更改卡券信息后，请务必调用<a href="../14/8dd77aeaee85f922db5f8aa6386d385e.html#.E6.9F.A5.E7.9C.8B.E5.8D.A1.E5.88.B8.E8.AF.A6.E6.83.85" class="external text" rel="nofollow">查看卡券详情接口</a>验证是否已成功更改。 </p>
      <p><br> <b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/card/update?access_token=TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/card/update?access_token=TOKEN</a>
</pre> 
      <p><b>参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> JSON数据 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST示例</b> </p> 
      <pre>{
   "card_id": "pbLatjgOY1_Cxi3mnWBThtG90HGg",
   "cash": {
       "base_info": {
           "code_type": "CODE_TYPE_TEXT",
           "color": "Color010",
           "service_phone": "020-88888888",
           "description": "不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出",
           "can_share": false,
           "can_give_friend": false,
           "location_id_list": [
               272981040,
               400183234
           ],
           "custom_url_name": "立即使用",
           "custom_url": "<a href="http://www.qq.com" class="external free" rel="nofollow">http://www.qq.com</a> ",
           "custom_url_sub_title": "6个汉字tips",
           "promotion_url_name": "更多优惠",
           "promotion_url": "<a href="http://www.qq.com" class="external free" rel="nofollow">http://www.qq.com</a>"
       },
       "advanced_info": {
           "time_limit": [
               {
                   "type": "MONDAY"
               },
               {
                   "type": "HOLIDAY"
               }
           ],
           "text_image_list": [
               {
                   "image_url": "<a href="http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0" class="external free" rel="nofollow">http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0</a>",
                   "text": "此菜品精选食材，以独特的烹饪方法，最大程度地刺激食客的味蕾"
               },
               {
                   "image_url": "<a href="http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0" class="external free" rel="nofollow">http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0</a>",
                   "text": "此菜品迎合大众口味，老少皆宜，营养均衡"
               }
           ],
           "business_service": [
               "BIZ_SERVICE_FREE_WIFI",
               "BIZ_SERVICE_WITH_PET",
               "BIZ_SERVICE_FREE_PARK",
               "BIZ_SERVICE_DELIVER"
           ],
           "consume_share_card_list": [
               {
                   "card_id": "pbLatjpvp0Xq6jtgRRxCKtudkBz8k",
                   "num": 1
               }
           ],
           "consume_share_self_num": 0,
           "abstract": {
               "abstract": "微信餐厅推出多种新季菜品，期待您的光临",
               "icon_url_list": [               "<a href="http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0" class="external free" rel="nofollow">http://mmbiz.qpic.cn/mmbiz/p98FjXy8LacgHxp3sJ3vn97bGLz0ib0Sfz1bjiaoOYA027iasqSG0sjpiby4vce3AtaPu6cIhBHkt6IjlkY9YnDsfw/0</a>"
               ]
           }
       }
   }
}
</pre> 
      <p><br> <b>字段说明</b> </p>
      <p>Base_info（卡券基础信息）字段修改： </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:50px">参数名 </th> 
         <th>是否提审 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td>base_info </td> 
         <td> - </td> 
         <td>JSON结构 </td> 
         <td> </td> 
         <td>卡券基础信息字段。 </td>
        </tr> 
        <tr> 
         <td>logo_url </td> 
         <td>是 </td> 
         <td>string(128) </td> 
         <td><a href="http://mmbiz.qpic.cn/" class="external free" rel="nofollow">http://mmbiz.qpic.cn/</a> </td> 
         <td>卡券的商户logo，建议像素为300*300。 </td>
        </tr> 
        <tr> 
         <td>notice </td> 
         <td>是 </td> 
         <td>string（48） </td> 
         <td>请出示二维码核销卡券。 </td> 
         <td>使用提醒，字数上限为16个汉字。 </td>
        </tr> 
        <tr> 
         <td>description </td> 
         <td>是 </td> 
         <td>string（3072） </td> 
         <td>不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食。 </td> 
         <td>使用说明。 </td>
        </tr> 
        <tr> 
         <td>service_phone </td> 
         <td>否 </td> 
         <td>string（24） </td> 
         <td>40012234 </td> 
         <td>客服电话。 </td>
        </tr> 
        <tr> 
         <td>color </td> 
         <td>是 </td> 
         <td>string（3072） </td> 
         <td>Color010 </td> 
         <td>卡券颜色。 </td>
        </tr> 
        <tr> 
         <td>location_id_list </td> 
         <td>否 </td> 
         <td>string（3072） </td> 
         <td>1234,2314 </td> 
         <td>支持更新适用门店列表。 </td>
        </tr> 
        <tr> 
         <td>center_title </td> 
         <td>否 </td> 
         <td>string（18） </td> 
         <td>快速使用 </td> 
         <td>顶部居中的自定义cell。 </td>
        </tr> 
        <tr> 
         <td>center_sub_title </td> 
         <td>否 </td> 
         <td>string（24） </td> 
         <td>点击快速核销卡券 </td> 
         <td>顶部居中的自定义cell说明。 </td>
        </tr> 
        <tr> 
         <td>center_url </td> 
         <td>否 </td> 
         <td>string（128） </td> 
         <td>www.xxx.com </td> 
         <td>顶部居中的自定义cell的跳转链接。 </td>
        </tr> 
        <tr> 
         <td>location_id_list </td> 
         <td>否 </td> 
         <td>string（3072） </td> 
         <td>1234,2314 </td> 
         <td>支持更新适用门店列表。 </td>
        </tr> 
        <tr> 
         <td>custom_url_name </td> 
         <td>否 </td> 
         <td>string（16） </td> 
         <td>立即使用 </td> 
         <td>自定义跳转入口的名字。 </td>
        </tr> 
        <tr> 
         <td>custom_url </td> 
         <td>否 </td> 
         <td>string（128） </td> 
         <td>"xxxx.com"。 </td> 
         <td>自定义跳转的URL。 </td>
        </tr> 
        <tr> 
         <td>custom_url_sub_title </td> 
         <td>否 </td> 
         <td>string（18） </td> 
         <td>更多惊喜 </td> 
         <td>显示在入口右侧的提示语。 </td>
        </tr> 
        <tr> 
         <td>promotion_url_name </td> 
         <td>否 </td> 
         <td>string（16） </td> 
         <td>产品介绍。 </td> 
         <td>营销场景的自定义入口名称。 </td>
        </tr> 
        <tr> 
         <td>promotion_url </td> 
         <td>否 </td> 
         <td>string（128） </td> 
         <td>XXXX.com； </td> 
         <td>入口跳转外链的地址链接。 </td>
        </tr> 
        <tr> 
         <td>promotion_url_sub_title </td> 
         <td>否 </td> 
         <td>string（18） </td> 
         <td>卖场大优惠。 </td> 
         <td>显示在营销入口右侧的提示语。 </td>
        </tr> 
        <tr> 
         <td>code_type </td> 
         <td>否 </td> 
         <td>string（16） </td> 
         <td>CODE_TYPE_TEXT。 </td> 
         <td>Code码展示类型，"CODE_TYPE_TEXT"，文本；"CODE_TYPE_BARCODE"，一维码 ；"CODE_TYPE_QRCODE"，二维码；"CODE_TYPE_ONLY_QRCODE",二维码无code显示；"CODE_TYPE_ONLY_BARCODE",一维码无code显示；"CODE_TYPE_NONE"，无code类型 </td>
        </tr> 
        <tr> 
         <td>get_limit </td> 
         <td>否 </td> 
         <td>int </td> 
         <td>1 </td> 
         <td>每人可领券的数量限制。 </td>
        </tr> 
        <tr> 
         <td>can_share </td> 
         <td>否 </td> 
         <td>bool </td> 
         <td>false </td> 
         <td>卡券原生领取页面是否可分享。 </td>
        </tr> 
        <tr> 
         <td>can_give_friend </td> 
         <td>否 </td> 
         <td>bool </td> 
         <td>false </td> 
         <td>卡券是否可转赠。 </td>
        </tr> 
        <tr> 
         <td>date_info </td> 
         <td>否 </td> 
         <td>Json结构 </td> 
         <td>见上述示例 </td> 
         <td>使用日期，有效期的信息，有效期时间修改仅支持有效区间的扩大。 </td>
        </tr> 
        <tr> 
         <td>type </td> 
         <td>否 </td> 
         <td>string </td> 
         <td>DATE_TYPE_FIX_TIME_RANGE </td> 
         <td>有效期类型，仅支持更改type为DATE_TYPE_FIX_TIME_RANGE 的时间戳。 </td>
        </tr> 
        <tr> 
         <td>begin_timestamp </td> 
         <td>否 </td> 
         <td>unsigned int </td> 
         <td>14300000 </td> 
         <td>固定日期区间专用，表示起用时间。（单位为秒） </td>
        </tr> 
        <tr> 
         <td>end_timestamp </td> 
         <td>否 </td> 
         <td>unsigned int </td> 
         <td>15300000 </td> 
         <td>固定日期区间专用，表示结束时间。最长可将卡券有效期延长至三个月。 </td>
        </tr> 
       </tbody>
      </table> 
      <p>Advanced_info（卡券高级信息）字段修改： </p>
      <p>特别注意，以下支持更新的字段不在基本信息base_info的结构中。 </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">参数名 </th> 
         <th>是否提审 </th> 
         <th>类型 </th> 
         <th>示例值 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> advanced_info </td> 
         <td> 是 </td> 
         <td> JSON结构 </td> 
         <td> </td> 
         <td> </td>
        </tr> 
        <tr> 
         <td> abstract </td> 
         <td> 否 </td> 
         <td> JSON结构 </td> 
         <td> 优惠详情摘要字段。 </td> 
         <td> </td>
        </tr> 
        <tr> 
         <td> abstract </td> 
         <td> 否 </td> 
         <td> string(60) </td> 
         <td> 简介。 </td> 
         <td> 本券限领一张，不能与其他优惠共同使用。 </td>
        </tr> 
        <tr> 
         <td> icon_url_list </td> 
         <td> 否 </td> 
         <td> string(3072) </td> 
         <td> 图片列表，仅支持填入一个封面图片链接，上传图片接口上传获取图片获得链接，填写非CDN链接会报错，并在此填入。建议图片尺寸像素900*375 </td> 
         <td> <a href="http://mmbiz.qpic.cn/mmbiz/xxxxx" class="external free" rel="nofollow">http://mmbiz.qpic.cn/mmbiz/xxxxx</a> </td>
        </tr> 
        <tr> 
         <td> text_image_list </td> 
         <td> 否 </td> 
         <td> string(3072) </td> 
         <td> 图文列表，显示在详情内页，优惠券券开发者须至少传入一组图文列表 </td> 
         <td> </td>
        </tr> 
        <tr> 
         <td>image_url </td> 
         <td>否 </td> 
         <td>string(3072) </td> 
         <td>图片链接，必须调用上传图片接口上传图片获得链接，并在此填入，否则报错 </td> 
         <td><a href="http://mmbiz.qpic.cn/mmbiz/xxxxx。" class="external free" rel="nofollow">http://mmbiz.qpic.cn/mmbiz/xxxxx。</a> </td>
        </tr> 
        <tr> 
         <td>text </td> 
         <td>否 </td> 
         <td>string(3072) </td> 
         <td>图文描述，5000字以内 </td> 
         <td>一般为商品详情介绍 </td>
        </tr> 
        <tr> 
         <td>business_service </td> 
         <td>否 </td> 
         <td>string(24) </td> 
         <td>商家服务类型 可多选,此处仅控制展示，不填则不显示 </td> 
         <td>BIZ_SERVICE_DELIVER 外卖服务；BIZ_SERVICE_FREE_PARK 停车位；BIZ_SERVICE_WITH_PET 可带宠物；BIZ_SERVICE_FREE_WIFI 免费Wi-Fi </td>
        </tr> 
        <tr> 
         <td>time_limit </td> 
         <td>是 </td> 
         <td>string(24) </td> 
         <td>使用时段限制 </td> 
         <td> </td>
        </tr> 
        <tr> 
         <td>type </td> 
         <td>是 </td> 
         <td>string（24） </td> 
         <td>MONDAY 周一 <p>TUESDAY 周二 WEDNESDAY 周三 THURSDAY 周四 FRIDAY 周五 SATURDAY 周六 SUNDAY 周日 HOLIDAY 假期通用 </p> </td> 
         <td>限制类型，可多选,此处仅控制展示，不填则不显示 </td>
        </tr> 
        <tr> 
         <td>consume_share_self_num </td> 
         <td>是 </td> 
         <td>int </td> 
         <td>核销后送券的数量，可设置核销后送本券的数量，限制传入1张，与consume_share_card_list互斥 </td> 
         <td>1 </td>
        </tr> 
        <tr> 
         <td>consume_share_card_list </td> 
         <td> 是 </td> 
         <td> JSON </td> 
         <td> 核销后赠送其他卡券的列表 </td> 
         <td> </td>
        </tr> 
        <tr> 
         <td> card_id </td> 
         <td> 是 </td> 
         <td> string（24） </td> 
         <td> pbLatjhvf1xBtaOIhYOCnp7Wv4DA </td> 
         <td> 核销后赠送的其他卡券card_id，目前仅支持填入一个共享券card_id，注意此处必须填入共享券 </td>
        </tr> 
        <tr> 
         <td> num </td> 
         <td> 是 </td> 
         <td> unsigned int </td> 
         <td> 1 </td> 
         <td> 核销后赠送的该card_id数目，目前仅支持填1 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据说明</b> </p>
      <p>数据示例： </p> 
      <pre>{
   "errcode":0,
   "errmsg":"ok",
   "send_check":false
}
</pre> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">参数名 </th> 
         <th>描述 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> 错误码，0为正常。 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> 错误信息。 </td>
        </tr> 
        <tr> 
         <td> send_check </td> 
         <td> 是否提交审核，false为修改后不会重新提审，true为修改字段后重新提审，该卡券的状态变为审核中。 </td>
        </tr> 
       </tbody>
      </table> 
      <h2> <span class="mw-headline" id=".E6.8B.89.E5.8F.96.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><b>拉取朋友的券数据接口</b></span></h2> 
      <p><b>接口简介及开发注意事项</b> </p>
      <p>为支持开发者调用API查看卡券相关数据，微信卡券团队封装数据接口并面向具备卡券功能权限的开发者开放使用。开发者调用该接口可获取本商户下的所有卡券相关的总数据以及指定卡券的相关数据。 </p> 
      <h3> <span class="mw-headline" id=".E6.8B.89.E5.8F.96.E5.8D.A1.E5.88.B8.E6.A6.82.E5.86.B5.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><b>拉取卡券概况数据接口</b></span></h3> 
      <p><b>接口说明</b> </p>
      <p>支持调用该接口拉取本商户的总体数据情况，包括时间区间内的各指标总量。 </p>
      <p><b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/datacube/getcardbizuininfo?access_token=ACCESS_TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/datacube/getcardbizuininfo?access_token=ACCESS_TOKEN</a>
</pre> 
      <p><b>请求参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>｛
 "begin_date":"2015-06-15",  //请开发者按示例格式填写日期，否则会报错date format error
 "end_date":"2015-06-30",
 "cond_source":  0
｝
</pre> 
      <p><br> 参数说明： </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">字段 </th> 
         <th>说明 </th> 
         <th>是否必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th>
        </tr> 
        <tr> 
         <td>begin_date </td> 
         <td>查询数据的起始时间。 </td> 
         <td>是 </td> 
         <td>string(16) </td> 
         <td>2015-06-15 </td>
        </tr> 
        <tr> 
         <td>end_date </td> 
         <td>查询数据的截至时间。 </td> 
         <td>是 </td> 
         <td>string(16) </td> 
         <td>2015-06-30 </td>
        </tr> 
        <tr> 
         <td>cond_source </td> 
         <td>卡券来源，0为公众平台创建的卡券数据、1是API创建的卡券数据 </td> 
         <td>是 </td> 
         <td>unsigned int </td> 
         <td>0 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据说明</b> 数据示例： </p> 
      <pre>{
    "list": [
       {
           "ref_date": "2015-06-23",
           "view_cnt": 1,
           "view_user": 1,
           "receive_cnt": 1,
           "receive_user": 1,
           "verify_cnt": 0,
           "verify_user": 0,
           "given_cnt": 0,
           "given_user": 0,
           "expire_cnt": 0,
           "expire_user": 0
       }
   ] 
}
</pre> 
      <p><br> 字段说明： </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">字段 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td>ref_date </td> 
         <td>日期信息 </td>
        </tr> 
        <tr> 
         <td>view_cnt </td> 
         <td>浏览次数 </td>
        </tr> 
        <tr> 
         <td>view_user </td> 
         <td>浏览人数 </td>
        </tr> 
        <tr> 
         <td>receive_cnt </td> 
         <td>领取次数 </td>
        </tr> 
        <tr> 
         <td>receive_user </td> 
         <td>领取人数 </td>
        </tr> 
        <tr> 
         <td>verify_cnt </td> 
         <td>使用次数 </td>
        </tr> 
        <tr> 
         <td>verify_user </td> 
         <td>使用人数 </td>
        </tr> 
        <tr> 
         <td>given_cnt </td> 
         <td>转赠次数 </td>
        </tr> 
        <tr> 
         <td>given_user </td> 
         <td>转赠人数 </td>
        </tr> 
        <tr> 
         <td>expire_cnt </td> 
         <td>过期次数 </td>
        </tr> 
        <tr> 
         <td>expire_user </td> 
         <td>过期人数 </td>
        </tr> 
       </tbody>
      </table> 
      <p>注意： </p>
      <p>1. 查询时间区间需&lt;=62天，否则报错{errcode: 61501，errmsg: "date range error"}； </p>
      <p>2. 传入时间格式需严格参照示例填写”2015-06-15”，否则报错{errcode":61500,"errmsg":"date format error"} </p> 
      <h3> <span class="mw-headline" id=".E8.8E.B7.E5.8F.96.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><b>获取朋友的券数据接口</b></span></h3> 
      <p><b>接口说明</b> </p>
      <p>支持开发者调用该接口拉取朋友的券在固定时间区间内的相关数据。 </p>
      <p><br> <b>接口调用请求说明</b> </p> 
      <pre>http请求方式: POST
<a href="https://api.weixin.qq.com/datacube/getcardcardinfo?access_token=ACCESS_TOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/datacube/getcardcardinfo?access_token=ACCESS_TOKEN</a>
</pre> 
      <p><b>请求参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:120px">参数 </th> 
         <th style="width:120px">是否必须 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> 是 </td> 
         <td> 调用接口凭证 </td>
        </tr> 
        <tr> 
         <td> POST数据 </td> 
         <td> 是 </td> 
         <td> Json数据 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>POST数据</b> </p> 
      <pre>｛
 "begin_date":"2015-06-15",
 "end_date":"2015-06-30",
 "cond_source": 0,
 "card_id": "po8pktyDLmakNY2fn2VyhkiEPqGE"
｝
</pre> 
      <p><br> </p>
      <p>参数说明： </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:100px">字段 </th> 
         <th>说明 </th> 
         <th>是否必填 </th> 
         <th>类型 </th> 
         <th>示例值 </th>
        </tr> 
        <tr> 
         <td>begin_date </td> 
         <td>查询数据的起始时间。 </td> 
         <td>是 </td> 
         <td>string(16) </td> 
         <td>2015-06-15 </td>
        </tr> 
        <tr> 
         <td>end_date </td> 
         <td>查询数据的截至时间。 </td> 
         <td>是 </td> 
         <td>string(16) </td> 
         <td>2015-06-30 </td>
        </tr> 
        <tr> 
         <td>cond_source </td> 
         <td>卡券来源，0为公众平台创建的卡券数据、1是API创建的卡券数据 </td> 
         <td>是 </td> 
         <td>unsigned int </td> 
         <td>0 </td>
        </tr> 
        <tr> 
         <td>card_id </td> 
         <td>卡券ID。填写后，指定拉出该卡券的相关数据。 </td> 
         <td>否 </td> 
         <td>string(32) </td> 
         <td>po8pktyDLmakNY2fn2VyhkiEPqGE </td>
        </tr> 
       </tbody>
      </table> 
      <p><br> <b>返回数据说明</b> 数据示例： </p> 
      <pre>{
    "list": [
       {
           "ref_date": "2015-06-23",
           "card_id": "po8pktyDLmakNY2fn2VyhkiEPqGE",
           "card_type":3,
           "view_cnt": 1,
           "view_user": 1,
           "receive_cnt": 1,
           "receive_user": 1,
           "verify_cnt": 0,
           "verify_user": 0,
           "given_cnt": 0,
           "given_user": 0,
           "expire_cnt": 0,
           "expire_user": 0
       }
   ]
}
</pre> 
      <p><br> 字段说明： </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="700px"> 
       <tbody>
        <tr> 
         <th style="width:350px">字段 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td>ref_date </td> 
         <td>日期信息 </td>
        </tr> 
        <tr> 
         <td>card_id </td> 
         <td>卡券ID </td>
        </tr> 
        <tr> 
         <td>card_type </td> 
         <td>cardtype:0：折扣券，1：代金券，2：礼品券，3：优惠券，4：团购券（暂不支持拉取特殊票券类型数据，电影票、飞机票、会议门票、景区门票） </td>
        </tr> 
        <tr> 
         <td>view_cnt </td> 
         <td>浏览次数 </td>
        </tr> 
        <tr> 
         <td>view_user </td> 
         <td>浏览人数 </td>
        </tr> 
        <tr> 
         <td>receive_cnt </td> 
         <td>领取次数 </td>
        </tr> 
        <tr> 
         <td>receive_user </td> 
         <td>领取人数 </td>
        </tr> 
        <tr> 
         <td>verify_cnt </td> 
         <td>使用次数 </td>
        </tr> 
        <tr> 
         <td>verify_user </td> 
         <td>使用人数 </td>
        </tr> 
        <tr> 
         <td>given_cnt </td> 
         <td>转赠次数 </td>
        </tr> 
        <tr> 
         <td>given_user </td> 
         <td>转赠人数 </td>
        </tr> 
        <tr> 
         <td>expire_cnt </td> 
         <td>过期次数 </td>
        </tr> 
        <tr> 
         <td>expire_user </td> 
         <td>过期人数 </td>
        </tr> 
       </tbody>
      </table> 
      <p>注意： </p>
      <p>1. 查询时间区间需&lt;=62天，否则报错{"errcode:" 61501，errmsg: "date range error"}； </p>
      <p>2. 传入时间格式需严格参照示例填写如”2015-06-15”，否则报错｛"errcode":"date format error"｝ </p> 
      <h1> <span class="mw-headline" id=".E6.88.91.E6.98.AF.E7.AC.AC.E4.B8.89.E6.96.B9.E5.BC.80.E5.8F.91.E8.80.85.2F.E6.9C.8D.E5.8A.A1.E5.95.86"><b>我是第三方开发者/服务商</b></span></h1> 
      <p>朋友的券目前率先开通了MP流程，同样支持接口创建朋友的券。目前第三方/服务商可以利用现有能力帮助没有开发能力的商户创建、投放并核销朋友的券，并管理朋友的券数据。 </p>
      <p>第三方/服务商可以通过以下流程完成朋友的券基本流程： </p>
      <p>1、第三方/服务商须登录<a href="https://open.weixin.qq.com/" class="external text" rel="nofollow">微信开放平台</a>申请成为公众号第三方平台，并全网发布,详情点击<a href="https://open.weixin.qq.com/cgi-bin/frame?t=home/wx_plugin_tmpl&amp;lang=zh_CN" class="external text" rel="nofollow">公众号第三方平台</a>。 </p>
      <p>2、商户通过公众号授权将公众账号的卡券权限集授权给第三方代调用接口，详情点击<a href="https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&amp;t=resource/res_list&amp;verify=1&amp;id=open1419318587&amp;token=&amp;lang=zh_CN" class="external text" rel="nofollow">代公众号调用接口</a>。 </p>
      <p>3、开发者根据垂直行业特点，帮助商户完成<a href="../10/333958907c5aae0581e93a24f2df8562.html#.E5.88.9B.E5.BB.BA.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8" class="external text" rel="nofollow">创建朋友的券</a>、<a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.8A.95.E6.94.BE" class="external text" rel="nofollow">投放朋友的券</a>、 <a href="../10/333958907c5aae0581e93a24f2df8562.html#.E9.85.8D.E7.BD.AE.E5.BA.93.E5.AD.98.E3.80.81.E5.85.85.E5.80.BC.E5.88.B8.E7.82.B9" class="external text" rel="nofollow">接口兑换库存、充值券点</a>、 <a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.A0.B8.E9.94.80" class="external text" rel="nofollow">核销朋友的券</a>并完成<a href="../10/333958907c5aae0581e93a24f2df8562.html#.E6.8B.89.E5.8F.96.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3" class="external text" rel="nofollow">朋友的券数据管理</a>。 </p>
      <p>4、对于有能力的开发者可以融合<a href="https://open.weixin.qq.com/cgi-bin/index?t=home/index&amp;lang=zh_CN" class="external text" rel="nofollow">第三方授权授权</a>和<a href="../18/09b278a393a8256e014f7621cf641156.html#.E5.BC.80.E5.8F.91.E8.80.85.E5.8D.8F.E5.8A.A9.E5.88.B6.E5.88.B8.EF.BC.88.E6.97.A0.E5.85.AC.E4.BC.97.E5.8F.B7.E6.A8.A1.E5.BC.8F.EF.BC.89" class="external text" rel="nofollow">第三方协助制券</a>等模式搭建自己的 卡券平台供子商户使用。 </p> 
      <h1> <span class="mw-headline" id=".E4.BA.A4.E6.B5.81.E5.8F.8D.E9.A6.88"><b>交流反馈</b></span></h1> 
      <p>朋友的券开发者可以加入开发者交流五群、六群（QQ群）：512568283、205482166，若开发过程中遇到问题，也可以发送邮件到weixin_card@foxmail.com 反馈。 </p> 
      <!-- 
NewPP limit report
Preprocessor node count: 346/1000000
Post-expand include size: 0/2097152 bytes
Template argument size: 0/2097152 bytes
Expensive parser function count: 0/100
--> 
      <div class="printfooter">
        取自“
       <a href="../10/333958907c5aae0581e93a24f2df8562.html">../10/333958907c5aae0581e93a24f2df8562.html</a>”
      </div> 
      <!-- /bodytext --> 
      <!-- catlinks --> 
      <div id="catlinks" class="catlinks catlinks-allhidden"></div> 
      <!-- /catlinks --> 
      <div class="visualClear"></div> 
     </div> 
     <!-- /bodyContent --> 
    </div> 
    <!-- /content --> 
   </div> 
  </div> 
  <!-- footer --> 
  <div class="foot" id="footer"> 
   <ul class="links ft" id="footer-places"> 
    <li class="links_item no_extra" id="footer-about"><a target="_blank" href="http://www.tencent.com/zh-cn/index.shtml">关于腾讯</a></li> 
    <li class="links_item" id="footer-policy"> <a target="_blank" href="#">服务协议</a></li> 
    <li class="links_item" id="footer-contactus"><a target="_blank" href="http://kf.qq.com/special_auto/weixin.html">客服中心</a></li> 
    <li class="links_item" id="footer-contactus"><a href="http://crm2.qq.com/page/portalpage/wpa.php?uin=40012345&amp;f=1&amp;ty=1&amp;ap=000011:400792:|f:Ggzpt1" target="_blank">在线客服</a></li> 
   </ul> 
   <ul id="footer-icons" class="noprint"> 
    <li id="footer-poweredbyico"> <a href="http://www.mediawiki.org/"><img src="../static/assets/1360f2593ddc8c336d455df43678bb00.png" alt="Powered by MediaWiki" width="88" height="31"></a> </li> 
   </ul> 
   <p class="copyright">Copyright&nbsp;© 2012-2016 Tencent. All Rights Reserved.</p> 
  </div> 
  <!-- /footer --> 
  <script src="../static/8de4f51dbc81a02504e69db45b414107.css"></script> 
  <script>if ( window.mediaWiki ) {
	mediaWiki.config.set({"wgCanonicalNamespace": "", "wgCanonicalSpecialPageName": false, "wgNamespaceNumber": 0, "wgPageName": "朋友的券专区", "wgTitle": "朋友的券专区", "wgAction": "view", "wgArticleId": 252, "wgIsArticle": true, "wgUserName": null, "wgUserGroups": ["*"], "wgCurRevisionId": 4199, "wgCategories": [], "wgBreakFrames": false, "wgRestrictionEdit": [], "wgRestrictionMove": []});
}
</script> 
  <script>if ( window.mediaWiki ) {
	mediaWiki.loader.load(["mediawiki.util", "mediawiki.legacy.wikibits", "mediawiki.legacy.ajax"]);
	mediaWiki.loader.go();
}
</script> 
  <script>if ( window.mediaWiki ) {
	mediaWiki.user.options.set({"ccmeonemails":0,"cols":80,"contextchars":50,"contextlines":5,"date":"default","diffonly":0,"disablemail":0,"disablesuggest":0,"editfont":"default","editondblclick":0,"editsection":1,"editsectiononrightclick":0,"enotifminoredits":0,"enotifrevealaddr":0,"enotifusertalkpages":1,"enotifwatchlistpages":0,"extendwatchlist":0,"externaldiff":0,"externaleditor":0,"fancysig":0,"forceeditsummary":0,"gender":"unknown","hideminor":0,"hidepatrolled":0,"highlightbroken":1,"imagesize":2,"justify":0,"math":1,"minordefault":0,"newpageshidepatrolled":0,"nocache":0,"noconvertlink":0,"norollbackdiff":0,"numberheadings":0,"previewonfirst":0,"previewontop":1,"quickbar":1,"rcdays":7,"rclimit":50,"rememberpassword":0,"rows":25,"searchlimit":20,"showhiddencats":0,"showjumplinks":1,"shownumberswatching":1,"showtoc":1,"showtoolbar":1,"skin":"vector","stubthreshold":0,"thumbsize":2,"underline":2,"uselivepreview":0,"usenewrc":0,"watchcreations":0,"watchdefault":0,"watchdeletion":0,
	"watchlistdays":3,"watchlisthideanons":0,"watchlisthidebots":0,"watchlisthideliu":0,"watchlisthideminor":0,"watchlisthideown":0,"watchlisthidepatrolled":0,"watchmoves":0,"wllimit":250,"variant":"zh-cn","language":"zh-cn","searchNs0":true,"searchNs1":false,"searchNs2":false,"searchNs3":false,"searchNs4":false,"searchNs5":false,"searchNs6":false,"searchNs7":false,"searchNs8":false,"searchNs9":false,"searchNs10":false,"searchNs11":false,"searchNs12":false,"searchNs13":false,"searchNs14":false,"searchNs15":false});;mediaWiki.loader.state({"user.options":"ready"});
}
</script> 
  <!-- fixalpha --> 
  <script type="text/javascript"> if ( window.isMSIE55 ) fixalpha(); </script> 
  <!-- /fixalpha --> 
  <!-- Served in 0.610 secs. --> 
  <script type="text/javascript">
		// @cunjinli
		setTimeout(function() {
			$("#mw-panel .portal .body li a").each(function() {
				var href = $(this).attr("href"),
				    idx = href.lastIndexOf("/");
				if (!/\.html$/.test(href)) return;

				if (idx>=0) href = href.substr(idx+1);
				var r = new RegExp(href+"$");
				if (r.test(location.href)) {
				    $(this).closest(".portal").find("h5").click();
				    return false;
				}
			});
		}, 100);
		</script>   
  <!-- Welcome to ask gy-team -->
  <!-- so -->
 </body>
</html>